Invoke-GPOZaurrContent

Aliases: Find-GPO

Namespace GPOZaurr

Aliases

Find-GPO

Invokes GPOZaurrContent function to retrieve Group Policy Objects information.

Remarks

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

PS >


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

PS >


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

PS >


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

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

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

Parameters

CategoriesOnly SwitchParameter optionalposition: namedpipeline: False: Indicates whether to retrieve only categories.
ExcludeDomains String[] optionalposition: namedpipeline: False: Specifies an array of domains to exclude from the search.
Extended SwitchParameter optionalposition: namedpipeline: False
ExtendedForestInformation IDictionary optionalposition: namedpipeline: False: Specifies additional information about the forest.
Forest String optionalposition: namedpipeline: Falsealiases: ForestName: Specifies the forest name to search for Group Policy Objects.
FullObjects SwitchParameter optionalposition: namedpipeline: False: Indicates whether to retrieve full objects.
GPOGUID String[] optionalposition: namedpipeline: False
GPOName String[] optionalposition: namedpipeline: Falsealiases: Name
IncludeDomains String[] optionalposition: namedpipeline: Falsealiases: Domain, Domains: Specifies an array of domains to include in the search.
Online SwitchParameter optionalposition: namedpipeline: False: Indicates whether to retrieve information online.
Open SwitchParameter optionalposition: namedpipeline: False: Indicates whether to open the output after retrieval.
OutputPath String optionalposition: namedpipeline: False: Specifies the path to save the output.
OutputType String[] optionalposition: namedpipeline: Falsevalues: 2: Specifies the type of output (HTML or Object).; Possible values: HTML, Object
SingleObject SwitchParameter optionalposition: namedpipeline: False: Indicates whether to retrieve a single object.
SkipCleanup SwitchParameter optionalposition: namedpipeline: False
SkipNormalize SwitchParameter optionalposition: namedpipeline: False: Indicates whether to skip normalization.
Splitter String optionalposition: namedpipeline: False: Specifies the delimiter to use for splitting information.
Type String[] optionalposition: namedpipeline: False: Specifies the type of information to retrieve.

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

Parameters

CategoriesOnly SwitchParameter optionalposition: namedpipeline: False: Indicates whether to retrieve only categories.
Extended SwitchParameter optionalposition: namedpipeline: False
FullObjects SwitchParameter optionalposition: namedpipeline: False: Indicates whether to retrieve full objects.
GPOPath String optionalposition: namedpipeline: False: Specifies the path to a specific Group Policy Object.
Online SwitchParameter optionalposition: namedpipeline: False: Indicates whether to retrieve information online.
Open SwitchParameter optionalposition: namedpipeline: False: Indicates whether to open the output after retrieval.
OutputPath String optionalposition: namedpipeline: False: Specifies the path to save the output.
OutputType String[] optionalposition: namedpipeline: Falsevalues: 2: Specifies the type of output (HTML or Object).; Possible values: HTML, Object
SingleObject SwitchParameter optionalposition: namedpipeline: False: Indicates whether to retrieve a single object.
SkipCleanup SwitchParameter optionalposition: namedpipeline: False
SkipNormalize SwitchParameter optionalposition: namedpipeline: False: Indicates whether to skip normalization.
Splitter String optionalposition: namedpipeline: False: Specifies the delimiter to use for splitting information.
Type String[] optionalposition: namedpipeline: False: Specifies the type of information to retrieve.