API Reference
Command
Remove-ADXACL
Removes a specific access rule from an Active Directory object with governance-capable execution options.
Examples
Generated fallback example from parameter set 'By ADObject'.
Remove-ADXACL -ADObject 'Value' -Identity 'Value' -Rights 'CreateChild' -ControlType 'Allow'
Generated fallback example from parameter set 'By Entry'.
Remove-ADXACL -Entry 'Value' -Identity 'Value' -Rights 'CreateChild' -ControlType 'Allow'
Common Parameters
This command supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable.
For more information, see about_CommonParameters.
Syntax
Remove-ADXACL -Security <ActiveDirectorySecurity> -Identity <IdentityInfo> -Rights <CreateChild> -ControlType <Allow|Deny> -Inheritance <All|Descendents|Children|SelfAndChildren> [-AllowWrite] [-Apply] [-DryRun <bool>] [-GovernanceMode <string>] [-Intent <string>] [-PassThru] [-WriteActorId <string>] [-WriteAuditCorrelationId <string>] [-WriteChangeReason <string>] [-WriteExecutionId <string>] [-WriteRollbackPlanId <string>] [-WriteRollbackProviderId <string>] [<CommonParameters>]#Parameter set:
By SecurityParameters
- Security ActiveDirectorySecurity
- ActiveDirectorySecurity instance to read or modify.
- Identity IdentityInfo
- Identity to remove.
- Rights AclRights
- Rights to match when removing. Possible values: None, CreateChild, Delete, ReadControl, WriteDacl, WriteOwner, GenericRead, GenericWrite, GenericExecute, ListChildren, DeleteChild, DeleteTree, ReadProperty, WriteProperty, ExtendedRight, Self, GenericAll
- Possible values:
CreateChild,Delete,ReadControl,WriteDacl,WriteOwner,GenericRead,GenericWrite,GenericExecute,ListChildren,DeleteChild,DeleteTree,ReadProperty,WriteProperty,ExtendedRight,Self,GenericAll - ControlType AccessControlType
- Access control type to match. Possible values: Allow, Deny
- Possible values:
Allow,Deny - Inheritance AclInheritance
- Inheritance flags to match. Possible values: None, All, Descendents, Children, SelfAndChildren
- Possible values:
All,Descendents,Children,SelfAndChildren - AllowWrite SwitchParameter
- Explicit write confirmation flag for mutating operations.
- Apply SwitchParameter
- Applies changes. Without this switch, the cmdlet runs in dry-run mode.
- DryRun bool
- Dry-run mode flag. Defaults to true; set to false (or use -Apply) to execute writes.
- GovernanceMode string
- Governance behavior mode. compatibility preserves legacy write defaults; enforced requires explicit governance flow.
- Intent string
- Execution intent (read_only or read_write). Default: read_only.
- PassThru SwitchParameter
- Returns the governed operation result object.
- WriteActorId string
- Write actor identifier.
- WriteAuditCorrelationId string
- Optional write audit correlation identifier.
- WriteChangeReason string
- Write change reason, ticket, or approval reference.
- WriteExecutionId string
- Write execution identifier for governance/audit correlation.
- WriteRollbackPlanId string
- Write rollback plan identifier.
- WriteRollbackProviderId string
- Optional write rollback provider identifier.
Outputs
ADPlayground.Acl.AdxAclGovernedOperationResult
Remove-ADXACL -Entry <DirectoryEntry> -Identity <IdentityInfo> -Rights <CreateChild> -ControlType <Allow|Deny> -Inheritance <All|Descendents|Children|SelfAndChildren> [-AllowWrite] [-Apply] [-DryRun <bool>] [-GovernanceMode <string>] [-Intent <string>] [-PassThru] [-WriteActorId <string>] [-WriteAuditCorrelationId <string>] [-WriteChangeReason <string>] [-WriteExecutionId <string>] [-WriteRollbackPlanId <string>] [-WriteRollbackProviderId <string>] [<CommonParameters>]#Parameter set:
By EntryParameters
- Entry DirectoryEntry
- DirectoryEntry object to read or modify.
- Identity IdentityInfo
- Identity to remove.
- Rights AclRights
- Rights to match when removing. Possible values: None, CreateChild, Delete, ReadControl, WriteDacl, WriteOwner, GenericRead, GenericWrite, GenericExecute, ListChildren, DeleteChild, DeleteTree, ReadProperty, WriteProperty, ExtendedRight, Self, GenericAll
- Possible values:
CreateChild,Delete,ReadControl,WriteDacl,WriteOwner,GenericRead,GenericWrite,GenericExecute,ListChildren,DeleteChild,DeleteTree,ReadProperty,WriteProperty,ExtendedRight,Self,GenericAll - ControlType AccessControlType
- Access control type to match. Possible values: Allow, Deny
- Possible values:
Allow,Deny - Inheritance AclInheritance
- Inheritance flags to match. Possible values: None, All, Descendents, Children, SelfAndChildren
- Possible values:
All,Descendents,Children,SelfAndChildren - AllowWrite SwitchParameter
- Explicit write confirmation flag for mutating operations.
- Apply SwitchParameter
- Applies changes. Without this switch, the cmdlet runs in dry-run mode.
- DryRun bool
- Dry-run mode flag. Defaults to true; set to false (or use -Apply) to execute writes.
- GovernanceMode string
- Governance behavior mode. compatibility preserves legacy write defaults; enforced requires explicit governance flow.
- Intent string
- Execution intent (read_only or read_write). Default: read_only.
- PassThru SwitchParameter
- Returns the governed operation result object.
- WriteActorId string
- Write actor identifier.
- WriteAuditCorrelationId string
- Optional write audit correlation identifier.
- WriteChangeReason string
- Write change reason, ticket, or approval reference.
- WriteExecutionId string
- Write execution identifier for governance/audit correlation.
- WriteRollbackPlanId string
- Write rollback plan identifier.
- WriteRollbackProviderId string
- Optional write rollback provider identifier.
Outputs
ADPlayground.Acl.AdxAclGovernedOperationResult
Remove-ADXACL -ADObject <string> -Identity <IdentityInfo> -Rights <CreateChild> -ControlType <Allow|Deny> -Inheritance <All|Descendents|Children|SelfAndChildren> [-AllowWrite] [-Apply] [-DryRun <bool>] [-GovernanceMode <string>] [-Intent <string>] [-PassThru] [-WriteActorId <string>] [-WriteAuditCorrelationId <string>] [-WriteChangeReason <string>] [-WriteExecutionId <string>] [-WriteRollbackPlanId <string>] [-WriteRollbackProviderId <string>] [<CommonParameters>]#Parameter set:
By ADObjectParameters
- ADObject string
- Distinguished name/path of the object to read or modify.
- Identity IdentityInfo
- Identity to remove.
- Rights AclRights
- Rights to match when removing. Possible values: None, CreateChild, Delete, ReadControl, WriteDacl, WriteOwner, GenericRead, GenericWrite, GenericExecute, ListChildren, DeleteChild, DeleteTree, ReadProperty, WriteProperty, ExtendedRight, Self, GenericAll
- Possible values:
CreateChild,Delete,ReadControl,WriteDacl,WriteOwner,GenericRead,GenericWrite,GenericExecute,ListChildren,DeleteChild,DeleteTree,ReadProperty,WriteProperty,ExtendedRight,Self,GenericAll - ControlType AccessControlType
- Access control type to match. Possible values: Allow, Deny
- Possible values:
Allow,Deny - Inheritance AclInheritance
- Inheritance flags to match. Possible values: None, All, Descendents, Children, SelfAndChildren
- Possible values:
All,Descendents,Children,SelfAndChildren - AllowWrite SwitchParameter
- Explicit write confirmation flag for mutating operations.
- Apply SwitchParameter
- Applies changes. Without this switch, the cmdlet runs in dry-run mode.
- DryRun bool
- Dry-run mode flag. Defaults to true; set to false (or use -Apply) to execute writes.
- GovernanceMode string
- Governance behavior mode. compatibility preserves legacy write defaults; enforced requires explicit governance flow.
- Intent string
- Execution intent (read_only or read_write). Default: read_only.
- PassThru SwitchParameter
- Returns the governed operation result object.
- WriteActorId string
- Write actor identifier.
- WriteAuditCorrelationId string
- Optional write audit correlation identifier.
- WriteChangeReason string
- Write change reason, ticket, or approval reference.
- WriteExecutionId string
- Write execution identifier for governance/audit correlation.
- WriteRollbackPlanId string
- Write rollback plan identifier.
- WriteRollbackProviderId string
- Optional write rollback provider identifier.
Outputs
ADPlayground.Acl.AdxAclGovernedOperationResult