Get-MtADGpoState
Synopsis
Section titled “Synopsis”Collects Active Directory Group Policy state information.
Syntax
Section titled “Syntax”Get-MtADGpoState [-Refresh] [-ProgressAction <ActionPreference>] [<CommonParameters>]Description
Section titled “Description”Collects GPO metadata, links, and permissions from Active Directory over LDAP. 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.
Each entry in GPOReports summarizes the GPO’s DACL: PermissionsPresent (the DACL has at least one entry), HasAuthenticatedUsers, HasEnterpriseDomainControllers and HasDomainComputers (an access-allowed entry for that principal applies to the GPO) and HasInheritedPermissions (an entry is inherited from the parent container). These are $null when the security descriptor of the GPO was not returned.
Examples
Section titled “Examples”Example 1
Section titled “Example 1”Get-MtADGpoStateReturns cached GPO state or collects if not already cached. Returns no data unless Active Directory was explicitly connected through Connect-Maester.
Example 2
Section titled “Example 2”Get-MtADGpoState -RefreshForces a fresh collection of GPO state data from Active Directory.
Parameters
Section titled “Parameters”-Refresh
Section titled “-Refresh”Forces a refresh of the data from Active Directory, bypassing the cache.
Type: SwitchParameterParameter Sets: (All)Aliases:
Required: FalsePosition: NamedDefault value: FalseAccept pipeline input: FalseAccept wildcard characters: False-ProgressAction
Section titled “-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: ActionPreferenceParameter Sets: (All)Aliases: proga
Required: FalsePosition: NamedDefault value: NoneAccept pipeline input: FalseAccept wildcard characters: FalseCommonParameters
Section titled “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.