API Reference
Command
Get-ADXGpoLink
Enumerates GPO link targets for a specific GPO by Id or Name. Defaults to forest-wide scan including Sites (Configuration NC). Use -Summary to return per-target counts (Enabled/Disabled/Broken) in one view.
Examples
Example 1: Show every link target for the Default Domain Policy
Get-ADXGpoLink -Id '31B2F340-016D-11D2-945F-00C04FB984F9'
Example 2: Summarize cross-domain links for a hardening GPO
Get-ADXGpoLink -Name 'Workstation Hardening' -Domain 'contoso.com','emea.contoso.com' -Summary -CrossDomainOnly
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
Get-ADXGpoLink -Id <Guid> [-CrossDomainOnly] [-Domain <string[]>] [-Scope <string[]>] [-Summary] [-TargetFilter <string>] [<CommonParameters>]Parameter set:
By IdParameters
- Id Guid
- GPO GUID (groupPolicyContainer objectGuid).
- CrossDomainOnly SwitchParameter
- Show only links that cross domain boundaries (e.g., GPO from Domain A linked in Domain B).
- Domain string[]
- Optional domain(s) to limit scope. When omitted, scans all forest domains.
- Scope string[]
- Restrict link discovery to specific target kinds (Domain, OU, Site, Container).
- Summary SwitchParameter
- Return a compact per-target summary with Enabled/Disabled/Broken counts.
- TargetFilter string
- Wildcard filter applied to the target distinguishedName or Site name.
Get-ADXGpoLink -Name <string> [-CrossDomainOnly] [-Domain <string[]>] [-Scope <string[]>] [-Summary] [-TargetFilter <string>] [<CommonParameters>]Parameter set:
By NameParameters
- Name string
- GPO display name.
- CrossDomainOnly SwitchParameter
- Show only links that cross domain boundaries (e.g., GPO from Domain A linked in Domain B).
- Domain string[]
- Optional domain(s) to limit scope. When omitted, scans all forest domains.
- Scope string[]
- Restrict link discovery to specific target kinds (Domain, OU, Site, Container).
- Summary SwitchParameter
- Return a compact per-target summary with Enabled/Disabled/Broken counts.
- TargetFilter string
- Wildcard filter applied to the target distinguishedName or Site name.