Command

Invoke-GPOZaurrContent

Module GPOZaurr

Invokes GPOZaurrContent function to retrieve Group Policy Objects information.

Syntax

Invoke-GPOZaurrContent [-CategoriesOnly] [-ExcludeDomains <String[]>] [-Extended] [-ExtendedForestInformation <IDictionary>] [-Forest <String>] [-FullObjects] [-GPOGUID <String[]>] [-GPOName <String[]>] [-IncludeDomains <String[]>] [-Online] [-Open] [-OutputPath <String>] [-OutputType <HTML|Object>] [-SingleObject] [-SkipCleanup] [-SkipNormalize] [-Splitter <String>] [-Type <String[]>] [<CommonParameters>]

Parameter set: Default

Invoke-GPOZaurrContent [-CategoriesOnly] [-Extended] [-FullObjects] [-GPOPath <String>] [-Online] [-Open] [-OutputPath <String>] [-OutputType <HTML|Object>] [-SingleObject] [-SkipCleanup] [-SkipNormalize] [-Splitter <String>] [-Type <String[]>] [<CommonParameters>]

Parameter set: Local

Description

This function retrieves Group Policy Objects information based on the specified parameters. It can search for GPOs in a forest, exclude specific domains, include specific domains, and provide extended forest information.

Examples

Authored help example

EXAMPLE 1

Invoke-GPOZaurrContent -Forest "Contoso" -IncludeDomains "Domain1", "Domain2" -Type "Security" -OutputType "HTML" -OutputPath "C:\Reports\GPOReport.html"
Retrieves security-related Group Policy Objects information for the specified domains and saves the output as an HTML file.

EXAMPLE 2

Invoke-GPOZaurrContent -GPOPath "CN={31B2F340-016D-11D2-945F-00C04FB984F9},CN=Policies,CN=System,DC=Contoso,DC=com" -Type "All" -OutputType "Object"
Retrieves all information for a specific Group Policy Object and outputs the result as an object.

EXAMPLE 3

Invoke-GPOZaurrContent -GPOName "Group Policy Test" -SingleObject | ConvertTo-Json -Depth 3
Quickly view GPO settings by name in JSON format for easy inspection.

Parameters

-CategoriesOnly SwitchParameter optional: Indicates whether to retrieve only categories.
-ExcludeDomains String[] optionalsets: Default: Specifies an array of domains to exclude from the search.
-Extended SwitchParameter optional: Specifies the extended switch.
-ExtendedForestInformation IDictionary optionalsets: Default: Specifies additional information about the forest.
-Forest String optionalaliases: ForestNamesets: Default: Specifies the forest name to search for Group Policy Objects.
-FullObjects SwitchParameter optional: Indicates whether to retrieve full objects.
-GPOGUID String[] optionalsets: Default: Specifies one or more values for gpoguid.
-GPOName String[] optionalaliases: Namesets: Default: Specifies one or more values for gpo name.
-IncludeDomains String[] optionalaliases: Domain, Domainssets: Default: Specifies an array of domains to include in the search.
-Online SwitchParameter optional: Indicates whether to retrieve information online.
-Open SwitchParameter optional: Indicates whether to open the output after retrieval.
-OutputPath String optional: Specifies the path to save the output.
-OutputType String[] optional: Specifies the type of output (HTML or Object).; Possible values: HTML, Object
-SingleObject SwitchParameter optional: Indicates whether to retrieve a single object.
-SkipCleanup SwitchParameter optional: Specifies the skip cleanup switch.
-SkipNormalize SwitchParameter optional: Indicates whether to skip normalization.
-Splitter String optional: Specifies the delimiter to use for splitting information.
-Type String[] optional: Specifies the type of information to retrieve.
-GPOPath String optionalsets: Local: Specifies the path to a specific Group Policy Object.

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.