Chat now with support
Chat with Support

GPOADmin 5.17 - 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 when users can modify objects 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

Get an object's security

Gets the security on the specified version controlled object. Security is set either to a container or directly on an object.

Get-Security [-Path] <String> [[-IncludeInheritedAce]] [-Raw] [-PipelineVariable <String>]

Get-Security -Path "VCRoot:\IE Settings"

Gets the security set on the "VCRoot:\IE Settings" object.

Get-Security -Path "VCRoot:\IE Settings" -IncludeInheritedAce

Gets the security set on the "VCRoot:\IE Settings" object including inheritance.

Get-Security -Path "VCRoot:\IE Settings" -IncludeInheritedAce -Raw

Gets the security set on the "VCRoot:\IE Settings" object including inheritance in its raw format.

Set an object's security

Sets the security on the specified version controlled object.

Set-Security [-Path] <String> [-Acl] <VersionControlAce[]> [-PipelineVariable <String>] [-WhatIf] [-Confirm]

$roles = get-roles

$ace1 = New-VCAce AMER\Administrator $roles[3]

$ace2 = New-VCAce AMER\jdoe $roles[3]

Set-Security -Path "VCRoot:\IE Settings" -Acl $ace1, $ace2

Sets the security on the specified version controlled object.

Overwrite a GPOs security filter

Overrides the security filter of the specified GPO.


To add a user or group:

$gpo = Get-Item VCRoot:\SOME_GPO

$filter = Get-SecurityFilter $gpo

$trustee = New-Trustee domain\user


Set-SecurityFilter $gpo $filter

To remove a specific trustee from the security filter, use the Get-SecurityFilter command and store the result in a variable. The result is a zero based list. If you know the index of the trustee you want to remove, use the RemoveAt command on the list.

$gpo = Get-Item VCRoot:\SOME_GPO

$filter = Get-SecurityFilter $gpo


Set-SecurityFilter $gpo $filter

If you know the name, you can first search for the trustee and store the account in a variable then user the Remove command.

$gpo = Get-Item VCRoot:\SOME_GPO

$filter = Get-SecurityFilter $gpo

$trustee = $filter | where{$_.Name –eq ‘domain\user’}


Set-SecurityFilter $gpo $filter

Protected Settings commands

The examples in this section deal with some of the basic GPOADmin Protected Settings commands. Protected Settings policies contain settings that you want to control. They are protected in the sense that they contain and identify the settings that may not be altered by users. This provides an added level of security for the policies within your organization. If a user attempts to create, edit, or remove the flagged settings they are stopped.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating