< Back

Add-NsFilesystemAcl

Sat Jan 18, 2020 5:12 pm

NAME Add-NsFilesystemAcl



SYNOPSIS

Adds to or Replaces the acls for a filesystem





SYNTAX

Add-NsFilesystemAcl [-Path] <String> [-Flags <String[]>] [-Permissions <String[]>] -Principal <String> [-Type

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





DESCRIPTION

Add an acl to a filesystem





PARAMETERS

-Path <String>



Required? true

Position? 1

Default value

Accept pipeline input? true (ByValue, ByPropertyName)

Accept wildcard characters? false



-Flags <String[]>



Required? false

Position? named

Default value @('file_inherit','dir_inherit')

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-Permissions <String[]>



Required? false

Position? named

Default value @('win_modify')

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-Principal <String>



Required? true

Position? named

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-Type <String>



Required? false

Position? named

Default value allow

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-Replace [<SwitchParameter>]

Invoke to replace existing ACLs rather than append to them



Required? false

Position? named

Default value False

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:\\>Add-FilesystemAcl -Path p2/top2 -Principal "usersid:user3@local.domain" | ft



type principal permissions flags

index

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

-----

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

0

allow 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

allow usersid:user3@local.domain {list_directory, read_data, add_file, write_data...} {file_inherit,

dir_inherit} 4



Creates a new acl for user3 giving them modify access to the filesystem











RELATED LINKS





CommonParameters : True

WorkflowCommonParameters : False

details : @{name=Add-NsProtectionServiceSchedule; noun=; verb=}

Syntax : @{syntaxItem=System.Object[]}

parameters : @{parameter=System.Object[]}

inputTypes : @{inputType=}

returnValues : @{returnValue=}

aliases : None



remarks : None

alertSet :

description :

examples :

Synopsis :

Add-NsProtectionServiceSchedule [-Name] <string> [[-Minutes] <string>] [[-Hours] <string>]

[[-DaysOfMonth] <string>] [[-Months] <string>] [[-DaysOfWeek] <string>] [[-Retain] <int>]

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



ModuleName : NexentaStor

nonTerminatingErrors :

xmlns:command : http://schemas.microsoft.com/maml/dev/command/2004/10

xmlns:dev : http://schemas.microsoft.com/maml/dev/2004/10

xmlns:maml : http://schemas.microsoft.com/maml/2004/10

Name : Add-NsProtectionServiceSchedule

Category : Function

Component :

Role :

Functionality :