< Back

Set-NsFilesystemAcl

Sat Jan 18, 2020 5:15 pm

NAME Set-NsFilesystemAcl



SYNOPSIS

Modifies the acls for a filesystem





SYNTAX

Set-NsFilesystemAcl [-Path] <String> [-Index] <Int32> [-Flags <String[]>] [-Permissions <String[]>] [-Principal

<String>] [-Type <String>] [-NoWait] [-WhatIf] [-Confirm] [<CommonParameters>]





DESCRIPTION

Get the acl information for a file system





PARAMETERS

-Path <String>



Required? true

Position? 1

Default value

Accept pipeline input? true (ByValue, ByPropertyName)

Accept wildcard characters? false



-Index <Int32>



Required? true

Position? 2

Default value 0

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-Flags <String[]>



Required? false

Position? named

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-Permissions <String[]>



Required? false

Position? named

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-Principal <String>



Required? false

Position? named

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-Type <String>



Required? false

Position? named

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-NoWait [<SwitchParameter>]

Invoke to make the cmdlet start the job and return the JobID.



Required? false

Position? named

Default value False

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-WhatIf [<SwitchParameter>]



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Confirm [<SwitchParameter>]



Required? false

Position? named

Default value

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

The cmdlet will wait (30sec) for the task to complete and return the updated acls, unless -NoWait was invoked.

If -NoWait was invoked, the cmdlet will return the GUID of the update task

If the cmdlet waits for more then 30sec it will return the GUID of the task.





-------------------------- EXAMPLE 1 --------------------------



PS C:\\>Set-FilesystemAcl -Path p2/top2 -Index 1 -Type deny | ft



type principal permissions flags

index

---- --------- ----------- -----

-----

allow usersid:user1@local.domain {list_directory, read_data, read_xattr, execute...} {file_inherit,

dir_inherit} 0

deny usersid:user2@local.domain {list_directory, read_data, add_file, write_data...} {file_inherit,

dir_inherit} 1

allow groupsid:Administrators@BUILTIN {list_directory, read_data, add_file, write_data...} {file_inherit,

dir_inherit} 2

allow owner@ {list_directory, read_data, add_file, write_data...} {file_inherit,

dir_inherit} 3



Changed the type of acl at index 1 to deny











RELATED LINKS