Command

Get-GPOZaurrAD

Module GPOZaurr

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

Syntax

Get-GPOZaurrAD [-DateFrom <DateTime>] [-DateProperty <WhenCreated|WhenChanged>] [-DateRange <String>] [-DateTo <DateTime>] [-ExcludeDomains <String[]>] [-ExtendedForestInformation <IDictionary>] [-Forest <String>] [-IncludeDomains <String[]>] [<CommonParameters>]

Parameter set: Default

Get-GPOZaurrAD [-DateFrom <DateTime>] [-DateProperty <WhenCreated|WhenChanged>] [-DateRange <String>] [-DateTo <DateTime>] [-ExcludeDomains <String[]>] [-ExtendedForestInformation <IDictionary>] [-Forest <String>] [-GPOName <String>] [-IncludeDomains <String[]>] [<CommonParameters>]

Parameter set: GPOName

Get-GPOZaurrAD [-DateFrom <DateTime>] [-DateProperty <WhenCreated|WhenChanged>] [-DateRange <String>] [-DateTo <DateTime>] [-ExcludeDomains <String[]>] [-ExtendedForestInformation <IDictionary>] [-Forest <String>] [-GPOGuid <String>] [-IncludeDomains <String[]>] [<CommonParameters>]

Parameter set: GPOGUID

Description

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

Get-GPOZaurrAD -GPOName "ExampleGPO"

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

EXAMPLE 2

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

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

EXAMPLE 3

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.

Parameters

-DateFrom DateTime optional: Specifies the start date for filtering GPOs based on creation or modification date.
-DateProperty String[] optional: Specifies the property (WhenCreated or WhenChanged) to use for filtering GPOs based on date.; Possible values: WhenCreated, WhenChanged
-DateRange String optional: 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 optional: Specifies the end date for filtering GPOs based on creation or modification date.
-ExcludeDomains String[] optional: Specifies an array of domains to exclude from the search.
-ExtendedForestInformation IDictionary optional: Specifies additional forest information to include in the output.
-Forest String optionalaliases: ForestName: Specifies the forest name to search for GPOs.
-IncludeDomains String[] optionalaliases: Domain, Domains: Specifies an array of domains to include in the search.
-GPOName String optionalsets: GPOName: Specifies the name of the GPO to retrieve.
-GPOGuid String optionalaliases: GPOID, GUIDsets: GPOGUID: Specifies the GUID of the GPO to retrieve.

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.