PowerShell Logo Small

Get-SmbShareAccess



This is the built-in help made by Microsoft for the command 'Get-SmbShareAccess', in PowerShell version 3 - as retrieved from Windows version 'Microsoft Windows Server 2012 Standard' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.

SYNOPSIS

Retrieves the access control list (ACL) of the Server Message Block (SMB) share.

SYNTAX


Get-SmbShareAccess [-Name] <String[]> [[-ScopeName] <String[]>] [-AsJob [<SwitchParameter>]] [-CimSession <CimSession[]>] [-ThrottleLimit
<Int32>] [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]
Get-SmbShareAccess [-AsJob [<SwitchParameter>]] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] -InputObject <CimInstance[]> [-Confirm
[<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Get-SMBShareAccess cmdlet gets objects that represent the rights that have been granted to security principles to access the Server
Message Block (SMB) share.



<

RELATED LINKS

Block-SmbShareAccess
Grant-SmbShareAccess
Revoke-SmbShareAccess
Unblock-SmbShareAccess

REMARKS

<

Examples


EXAMPLE 1

PS C:\> Get-SmbShareAccess –Name VMFiles
Name ScopeName AccountName AccessControlType AccessRight
---- --------- ----------- ----------------- -----------
VMFiles Contoso-SO Contoso\Administrator Allow Full
VMFiles Contoso-SO Contoso\Contoso-HV1$ Allow Full



This example retrieves the ACL of an SMB share named VMFiles.




EXAMPLE 2

PS C:\> Get-SmbShareAccess -Name VMFiles -ScopeName Contoso-SO | Format-List

Name : VMFiles
ScopeName : Contoso-SO
AccountName : Contoso\Administrator
AccessControlType : Allow
AccessRight : Full

Name : VMFiles
ScopeName : Contoso-SO
AccountName : Contoso\Contoso-HV1$
AccessControlType : Allow
AccessRight : Full



This example displays the information about the ACL of an SMB share named VMFiles connected to the SMB server named Contoso-SO.