Get-MtADDacls
SYNOPSIS
Collects Active Directory ACLs (Access Control Lists).
SYNTAX
Get-MtADDacls [[-DnBase] <String[]>] [-Refresh] [-ProgressAction <ActionPreference>] [<CommonParameters>]
DESCRIPTION
Collects ACLs from AD objects including domains, OUs, GPOs, users, computers, and groups. Results are cached for the session to avoid repeated queries. Connect-Maester -Service ActiveDirectory must complete successfully before this command can collect or return data.
EXAMPLES
EXAMPLE 1
Get-MtADDacls
Returns cached DACLs or collects if not already cached. Returns no data unless Active Directory was explicitly connected through Connect-Maester.
EXAMPLE 2
Get-MtADDacls -Refresh
Forces a fresh collection of ACL data from Active Directory.
EXAMPLE 3
Get-MtADDacls -DnBase "OU=Users,DC=contoso,DC=com"
Collects ACLs only from the specified OU.
PARAMETERS
-DnBase
The distinguished name base(s) to search. Defaults to the domain root.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Refresh
Forces a refresh of the data from Active Directory, bypassing the cache.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-ProgressAction
Determines how PowerShell responds to progress updates generated by a script, cmdlet, or provider, such as the progress bars generated by Write-Progress.
Type: ActionPreference
Parameter Sets: (All)
Aliases: proga
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.