Evotec

Project

GPOZaurr

GPOZaurr helps inspect, report on, and remediate Group Policy environments with PowerShell.

Stars 1,166
Forks 115
Open issues 16
PowerShell Gallery downloads 417,764
Release v1.1.9
Language: PowerShell Updated: 2026-04-11

API Reference

Function

Get-GPOZaurrAD

Namespace GPOZaurr

Retrieves Group Policy Objects (GPOs) information from Active Directory.

Remarks

This function retrieves information about Group Policy Objects (GPOs) from Active Directory based on specified criteria such as GPO name, GPO GUID, date range, and forest details.

Examples

Authored help example

EXAMPLE 1

PS >


Get-GPOZaurrAD -GPOName "ExampleGPO"
        

Description: Retrieves information about a GPO with the name "ExampleGPO".

EXAMPLE 2

PS >


Get-GPOZaurrAD -GPOGuid "{12345678-1234-1234-1234-123456789012}"
        

Description: Retrieves information about a GPO with the specified GUID.

EXAMPLE 3

PS >


Get-GPOZaurrAD -Forest "example.com" -IncludeDomains "domain1", "domain2" -DateRange "Last30Days"
        

Description: Retrieves GPO information from the forest "example.com" for domains "domain1" and "domain2" created or modified in the last 30 days.

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-GPOZaurrAD [-DateFrom <DateTime>] [-DateProperty <WhenCreated|WhenChanged>] [-DateRange <PastHour>] [-DateTo <DateTime>] [-ExcludeDomains <String[]>] [-ExtendedForestInformation <IDictionary>] [-Forest <String>] [-IncludeDomains <String[]>] [<CommonParameters>]
#
Parameter set: Default

Parameters

DateFrom DateTime optionalposition: namedpipeline: False
Specifies the start date for filtering GPOs based on creation or modification date.
DateProperty String[] optionalposition: namedpipeline: Falsevalues: 2
Specifies the property (WhenCreated or WhenChanged) to use for filtering GPOs based on date.
Possible values: WhenCreated, WhenChanged
DateRange String optionalposition: namedpipeline: Falsevalues: 14
Specifies a predefined date range for filtering GPOs based on creation or modification date.
Possible values: PastHour, CurrentHour, PastDay, CurrentDay, PastMonth, CurrentMonth, PastQuarter, CurrentQuarter, Last14Days, Last21Days, Last30Days, Last7Days, Last3Days, Last1Days
DateTo DateTime optionalposition: namedpipeline: False
Specifies the end date for filtering GPOs based on creation or modification date.
ExcludeDomains String[] optionalposition: namedpipeline: False
Specifies an array of domains to exclude from the search.
ExtendedForestInformation IDictionary optionalposition: namedpipeline: False
Specifies additional forest information to include in the output.
Forest String optionalposition: namedpipeline: Falsealiases: ForestName
Specifies the forest name to search for GPOs.
IncludeDomains String[] optionalposition: namedpipeline: Falsealiases: Domain, Domains
Specifies an array of domains to include in the search.
Get-GPOZaurrAD [-DateFrom <DateTime>] [-DateProperty <WhenCreated|WhenChanged>] [-DateRange <PastHour>] [-DateTo <DateTime>] [-ExcludeDomains <String[]>] [-ExtendedForestInformation <IDictionary>] [-Forest <String>] [-GPOName <String>] [-IncludeDomains <String[]>] [<CommonParameters>]
#
Parameter set: GPOName

Parameters

DateFrom DateTime optionalposition: namedpipeline: False
Specifies the start date for filtering GPOs based on creation or modification date.
DateProperty String[] optionalposition: namedpipeline: Falsevalues: 2
Specifies the property (WhenCreated or WhenChanged) to use for filtering GPOs based on date.
Possible values: WhenCreated, WhenChanged
DateRange String optionalposition: namedpipeline: Falsevalues: 14
Specifies a predefined date range for filtering GPOs based on creation or modification date.
Possible values: PastHour, CurrentHour, PastDay, CurrentDay, PastMonth, CurrentMonth, PastQuarter, CurrentQuarter, Last14Days, Last21Days, Last30Days, Last7Days, Last3Days, Last1Days
DateTo DateTime optionalposition: namedpipeline: False
Specifies the end date for filtering GPOs based on creation or modification date.
ExcludeDomains String[] optionalposition: namedpipeline: False
Specifies an array of domains to exclude from the search.
ExtendedForestInformation IDictionary optionalposition: namedpipeline: False
Specifies additional forest information to include in the output.
Forest String optionalposition: namedpipeline: Falsealiases: ForestName
Specifies the forest name to search for GPOs.
GPOName String optionalposition: namedpipeline: False
Specifies the name of the GPO to retrieve.
IncludeDomains String[] optionalposition: namedpipeline: Falsealiases: Domain, Domains
Specifies an array of domains to include in the search.
Get-GPOZaurrAD [-DateFrom <DateTime>] [-DateProperty <WhenCreated|WhenChanged>] [-DateRange <PastHour>] [-DateTo <DateTime>] [-ExcludeDomains <String[]>] [-ExtendedForestInformation <IDictionary>] [-Forest <String>] [-GPOGuid <String>] [-IncludeDomains <String[]>] [<CommonParameters>]
#
Parameter set: GPOGUID

Parameters

DateFrom DateTime optionalposition: namedpipeline: False
Specifies the start date for filtering GPOs based on creation or modification date.
DateProperty String[] optionalposition: namedpipeline: Falsevalues: 2
Specifies the property (WhenCreated or WhenChanged) to use for filtering GPOs based on date.
Possible values: WhenCreated, WhenChanged
DateRange String optionalposition: namedpipeline: Falsevalues: 14
Specifies a predefined date range for filtering GPOs based on creation or modification date.
Possible values: PastHour, CurrentHour, PastDay, CurrentDay, PastMonth, CurrentMonth, PastQuarter, CurrentQuarter, Last14Days, Last21Days, Last30Days, Last7Days, Last3Days, Last1Days
DateTo DateTime optionalposition: namedpipeline: False
Specifies the end date for filtering GPOs based on creation or modification date.
ExcludeDomains String[] optionalposition: namedpipeline: False
Specifies an array of domains to exclude from the search.
ExtendedForestInformation IDictionary optionalposition: namedpipeline: False
Specifies additional forest information to include in the output.
Forest String optionalposition: namedpipeline: Falsealiases: ForestName
Specifies the forest name to search for GPOs.
GPOGuid String optionalposition: namedpipeline: Falsealiases: GPOID, GUID
Specifies the GUID of the GPO to retrieve.
IncludeDomains String[] optionalposition: namedpipeline: Falsealiases: Domain, Domains
Specifies an array of domains to include in the search.