Chat now with support
Chat with Support

GPOADmin 5.20 - 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)
Creating a custom container hierarchy Selecting security, levels of approval, and notification options Viewing the differences between objects Copying/pasting objects Proposing the creation of controlled objects Merging GPOs Restoring an object to a previous version Restoring links to a previous version Managing your links with search and replace Linking GPOs to multiple Scopes of Management Managing compliance issues automatically with remediation rules Validating GPOs Managing GPO revisions with lineage Setting the change window for specific actions Working with registered objects Working with available objects Working with checked out objects Working with objects pending approval and deployment
Checking compliance Editing objects Synchronizing GPOs Exporting and importing
Creating Reports 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

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.

Syntax

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

Examples

$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.

* 
NOTE: The number in an array starts at zero so if you want to register the fifth item then you need the offset to be four [4] as seen above.

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.

Syntax

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

Example

$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.

Syntax

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

Example:

$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.

Undo the check out of an object

If you have an object checked out and realize that you do not need to work on it, do not want to save your changes, or have checked out the wrong object, you can undo the checkout. This checks the object back into the Version Controlled Root and disregard any changes.

Syntax

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

Example

$GPO = Get-Item "IE Settings"

Select-UndoCheckout $GPO

The Get-Item command identifies which object to undo the check out for. In this case, IE Settings is the GPO you want to check back in and set back to its original condition without any changes.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating