Set-AdsAcl

NAME Set-AdsAcl



SYNOPSIS

Updates the ACL on an active directory object.





SYNTAX

Set-AdsAcl [[-Path] <String>] [-AclObject] <ActiveDirectorySecurity> [[-Server] <String>] [[-Credential]

<PSCredential>] [-EnableException] [-WhatIf] [-Confirm] [<CommonParameters>]





DESCRIPTION

Updates the ACL on an active directory object.

Used to manage AD delegation.





PARAMETERS

-Path <String>

The path / distinguishedname to the object to manage.



Required? false

Position? 1

Default value

Accept pipeline input? false

Accept wildcard characters? false



-AclObject <ActiveDirectorySecurity>

The acl to apply



Required? true

Position? 2

Default value

Accept pipeline input? true (ByValue)

Accept wildcard characters? false



-Server <String>

The server / domain to connect to.



Required? false

Position? 3

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Credential <PSCredential>

The credentials to use for AD operations.



Required? false

Position? 4

Default value

Accept pipeline input? false

Accept wildcard characters? false



-EnableException [<SwitchParameter>]

This parameters disables user-friendly warnings and enables the throwing of exceptions.

This is less user friendly, but allows catching exceptions in calling scripts.



Required? false

Position? named

Default value False

Accept pipeline input? false

Accept wildcard characters? false



-WhatIf [<SwitchParameter>]

If this switch is enabled, no actions are performed but informational messages will be displayed that explain

what would happen if the command were to run.



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Confirm [<SwitchParameter>]

If this switch is enabled, you will be prompted for confirmation before executing any operations that change

state.



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



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



PS C:\\>$acl | Set-AdsAcl



Applies the acl object(s) stored in $acl.

Assumes that 'Get-AdsAcl' was used to retrieve the data originally.









-------------------------- EXAMPLE 2 --------------------------



PS C:\\>Set-AdsAcl -AclObject $acl -Path $dn -Server fabrikam.com



Updates the acl on the object stored in $dn within the fabrikam.com domain.











RELATED LINKS