Get-ControlledGpo
Gets controlled GPOs for a domain.
Syntax
Get-ControlledGpo
[-Domain <String>]
[<CommonParameters>] Description
The Get-ControlledGpo cmdlet gets the controlled Group Policy Objects (GPOs) from an Advanced Group Policy Management (AGPM) archive for a domain.
You can use this cmdlet to view state information for controlled GPOs.
Use the Get-Gpo cmdlet to view uncontrolled GPOs.
For more information, type Get-Help Get-Gpo.
Examples
Example 1: Get all GPOs and then filter results
PS C:\>Get-ControlledGpo -Domain "TQSA.Contoso.com" | Where {$_.name -eq "TSQA Group policies"}
Name : TSQA Group policies
ID : {5507363B-6AEB-4EFF-89FD-1567CD1E14E5}
CheckoutID :
BackupID : {70D90CA2-E396-4549-A2C9-18EED518F6F1}
State : CHECKED_IN
ComputerVersion : 2
UserVersion : 2
Deployed : 11/25/2014 9:54:11 AM
Changed : 11/25/2014 9:54:12 AM
ChangedBy : CONTOSO\Admin07
WmiFilterName :
Comment :This command gets all controlled GPOs from the domain TQSA.Contoso.com, and then passes them to the Where-Object cmdlet. That cmdlet returns the GPO from those results named TSQA Group policies.
Parameters
-Domain
Specifies the fully qualified domain name (FQDN) of a domain. This cmdlet gets GPOs in the domain that this parameter specifies. If the AGPM service runs as part of a different domain, and if this cmdlet specifies that domain, a trust relationship must exist between that domain and the domain of the current user or computer.
If you do not specify a domain, this cmdlet uses the domain of the current user.
If you use this cmdlet as part of a computer startup or shutdown script, and if the command does not specify this parameter, the cmdlet uses the domain of the computer.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Inputs
None
Outputs
Microsoft.Agpm.ControlledGpo
This cmdlet returns controlled GPO objects.