< Back
Set-SmbPathAcl
Post
NAME Set-SmbPathAcl
SYNOPSIS
Sets the ACL for the file system folder to match the ACL used by an SMB share.
SYNTAX
Set-SmbPathAcl [-ShareName] <String> [[-ScopeName] <String>] [<CommonParameters>]
DESCRIPTION
The Set-SmbPathAcl cmdlet sets the access control list (ACL) for the file system folder to match the ACL for the server message block (SMB) share. The
cmdlet sets the ACL to match the SMB share itself. This action simplifies the configuration of NTFS or ReFS file system permissions by copying the SMB
share permissions.
PARAMETERS
-ScopeName [<String>]
Specifies the scope name of the SMB share. The cmdlet sets the ACL for the scope that you specify.
Required? false
Position? 2
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-ShareName <String>
Specifies the name of the SMB share. The cmdlet sets the ACL on the file system folder to the ACL used by the SMB share that you specify.
Required? true
Position? 1
Default value none
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
NOTES
The previous syntax for the same task, ((Get-SmbShare ????????Name <ShareName> ).PresetPathACL | Set-Acl), continues to work with newer versions of the
Windows Server operating system, but the new syntax is much simpler and therefore recommended.
Example 1: Set the SMB path ACL by share name
PS C:\\> Set-SmbPathAcl -ShareName "Share01"
This command sets the ACL on the file system folder used by the Share01 share to match the ACL of the share.
Example 2: Set the SMB path ACL by share name and scope name
PS C:\\> Set-SmbPathAcl -ShareName "Share01" -ScopeName "SOFS01"
This command sets the ACL on the file system folder used by the Share01 share on the SOFS01 scope to match the ACL of the share.
RELATED LINKS
SMB Share Cmdlets in Windows PowerShell
SYNOPSIS
Sets the ACL for the file system folder to match the ACL used by an SMB share.
SYNTAX
Set-SmbPathAcl [-ShareName] <String> [[-ScopeName] <String>] [<CommonParameters>]
DESCRIPTION
The Set-SmbPathAcl cmdlet sets the access control list (ACL) for the file system folder to match the ACL for the server message block (SMB) share. The
cmdlet sets the ACL to match the SMB share itself. This action simplifies the configuration of NTFS or ReFS file system permissions by copying the SMB
share permissions.
PARAMETERS
-ScopeName [<String>]
Specifies the scope name of the SMB share. The cmdlet sets the ACL for the scope that you specify.
Required? false
Position? 2
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-ShareName <String>
Specifies the name of the SMB share. The cmdlet sets the ACL on the file system folder to the ACL used by the SMB share that you specify.
Required? true
Position? 1
Default value none
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
NOTES
The previous syntax for the same task, ((Get-SmbShare ????????Name <ShareName> ).PresetPathACL | Set-Acl), continues to work with newer versions of the
Windows Server operating system, but the new syntax is much simpler and therefore recommended.
Example 1: Set the SMB path ACL by share name
PS C:\\> Set-SmbPathAcl -ShareName "Share01"
This command sets the ACL on the file system folder used by the Share01 share to match the ACL of the share.
Example 2: Set the SMB path ACL by share name and scope name
PS C:\\> Set-SmbPathAcl -ShareName "Share01" -ScopeName "SOFS01"
This command sets the ACL on the file system folder used by the Share01 share on the SOFS01 scope to match the ACL of the share.
RELATED LINKS
SMB Share Cmdlets in Windows PowerShell