Chat now with support
Chat with Support

GPOADmin 5.15 - User Guide

Introducing Quest GPOADmin Configuring GPOADmin Using GPOADmin
Connecting to the Version Control system Navigating the GPOADmin console Search folders Accessing the GPMC extension Configuring user preferences Working with the live environment Working with controlled objects (version control root) Checking compliance Editing objects Synchronizing GPOs Exporting and importing
Creating Reports Working with the GPOADmin Dashboard Appendix: Windows PowerShell Commands Appendix: GPOADmin Event Log Appendix: GPOADmin Backup and Recovery Procedures Appendix: Customizing your workflow Appendix: GPOADmin Silent Installation Commands Appendix: Configuring Gmail for Notifications Appendix: Registering GPOADmin for Office 365 Exchange Online Appendix: GPOADmin with SQL Replication About Us

Get unregistered objects

This command returns information on any objects that are not registered in GPOADmin for a specified domain. You can use this information, to now register the objects if necessary. See Register an object.

Get-Unregistered [-Domain <String>] [-GPOs] [-ProtectedSettings] [-WMIFilters] [-SOMs] [-OUs] [-Domains] [-Sites] [-Scripts] [-SortBy <SortField>] [-Descending] [-Count] [-PipelineVariable <String>]


Returns information about all unregistered objects in the current domain.


Get-Unregistered -Domain -OUs

Returns information about OUs in the domain specified.

Register an object

Before you can control an object in GPOADmin, you must register it. To simplify the process, you can pipe values into this command to register a group of selected objects.

Select-Register [-VCData] <VersionControllableData> [[-Container] <String>] [[-Comment] <String>] [[-MajorVersion] <Int32>] [[-WorkflowDisabled]] [-PipelineVariable <String>] [-WhatIf] [-Confirm]

$unregisteredWMI = Get-Unregistered –WMI

$registeredWMI = $unregisteredWMI | Select-Register -Container "VCRoot:"

The Get-Unregistered places the data about the WMI filters into an array, then this data in used to register all of the WMI filters and puts them into a specific container. The container must be created before using this command.

Get-Unregisterd -WMI | Select-Register -Container "VCRoot:\WMI Filters"

In this example, the operation is the same as above but it does not place the unregistered objects into a variable first instead it pipes the unregistered WMI filters directly into the Select-Register command.


$unregisteredWMI = Get-Unregistered –WMI

$registeredWMI = $unregisteredWMI[4] | Select-Register -Container "VCRoot:"

In this example, the unregistered objects are placed into an array of objects. If you enter the array name, it lists all the items in the array. From there you can select a specific object in the array and register it.

Check out an object

Use this command to check out an object so you can work on it. A check out is required on any workflow enabled object before you can edit it.

Select-Checkout [-VCData] <VersionControlledData> [[-Comment] <String>] [-PipelineVariable <String>] [-WhatIf] [-Confirm]

$GPO = Get-Item "IE Settings"

Select-CheckOut $GPO

The Get-Item command identifies the object to check out. In this case, IE Settings is the GPO that is checked out and available to work on.

Check in an object

Once an object has been checked and worked on, it can be checked back in to the version control system.

Select-CheckIn [-VCData] <VersionControlledData> [[-Comment] <String>] [-PipelineVariable <String>] [-WhatIf] [-Confirm]

$GPO = Get-Item "IE Settings"

Select-CheckIn $GPO

The Get-Item command identifies the object to check in. In this case, IE Settings is the GPO to check back in after having worked on it.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating