API Reference
Command
Set-ADXAclGoverned
Runs a governance-aware ACL set operation with dry-run/apply semantics.
Examples
Generated fallback example from parameter set 'By ADObject'.
Set-ADXAclGoverned -ADObject 'Value' -Requests @('Value')
Generated fallback example from parameter set 'By Entry'.
Set-ADXAclGoverned -Entry 'Value' -Requests @('Value')
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
Set-ADXAclGoverned -Security <ActiveDirectorySecurity> -Requests <AdxAclPermissionRequest[]> [-AllowWrite] [-Apply] [-DryRun <bool>] [-Intent <string>] [-WriteActorId <string>] [-WriteAuditCorrelationId <string>] [-WriteChangeReason <string>] [-WriteExecutionId <string>] [-WriteRollbackPlanId <string>] [-WriteRollbackProviderId <string>] [<CommonParameters>]#Parameter set:
By SecurityParameters
- Security ActiveDirectorySecurity
- ActiveDirectorySecurity instance to modify.
- Requests AdxAclPermissionRequest[]
- Desired permission entries.
- 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. If both switches are provided, -Apply takes precedence.
- Intent string
- Execution intent (read_only or read_write). Default: read_only.
- 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
Set-ADXAclGoverned -Entry <DirectoryEntry> -Requests <AdxAclPermissionRequest[]> [-AllowWrite] [-Apply] [-DryRun <bool>] [-Intent <string>] [-WriteActorId <string>] [-WriteAuditCorrelationId <string>] [-WriteChangeReason <string>] [-WriteExecutionId <string>] [-WriteRollbackPlanId <string>] [-WriteRollbackProviderId <string>] [<CommonParameters>]#Parameter set:
By EntryParameters
- Entry DirectoryEntry
- DirectoryEntry object to modify.
- Requests AdxAclPermissionRequest[]
- Desired permission entries.
- 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. If both switches are provided, -Apply takes precedence.
- Intent string
- Execution intent (read_only or read_write). Default: read_only.
- 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
Set-ADXAclGoverned -ADObject <string> -Requests <AdxAclPermissionRequest[]> [-AllowWrite] [-Apply] [-DryRun <bool>] [-Intent <string>] [-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 modify.
- Requests AdxAclPermissionRequest[]
- Desired permission entries.
- 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. If both switches are provided, -Apply takes precedence.
- Intent string
- Execution intent (read_only or read_write). Default: read_only.
- 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