Chat now with support
Chat with Support

GPOADmin 5.17 - Quick Start Guide

Configuring the GPOADmin Server

* 
NOTE: To run the Server Configuration Wizard, you must logon with an account that is a member of the Enterprise Administrators group or the GPOADmin Service Account.

The Version Control server must be configured before users can connect to the Version Control system.

To configure the GPOADmin Server
1
Run All Programs | Quest | GPOADmin from the Start menu.
2
In the GPOADmin console, right-click the GPOADmin node and select Connect.
3
In the Connect to Server dialog box click Connect to connect with the current logged on user credentials or select the down arrow in the Connect button and select Connect As to enter new credentials (domain\user and password).
4
To save the credentials, select the Remember my password check box and click OK.
5
In the Select a Configuration Store dialog box, select AD LDS, Active Directory, or SQL for your configuration storage location.
* 
NOTE: Configuration Store Selection

The best practice is to use AD LDS as the configuration store. However, in large environments, SQL server is the recommended option. Quest uses the following criteria to define large environments:

•
Domains with more than 500 registered objects that run searches on a regular basis.
•
More than 500 registered containers.
•
Containers with objects nested more than 3 levels deep.

These are guidelines and should not be considered as an exhaustive list.

If you select AD LDS, enter the NetBIOS name of the computer you are installing to followed by the port number, in the format: server_name:port, and click Next. For example, gpoadmin_svr:389.
If you select Active Directory, select the domain controller (DC) to be the Version Control server, and click Next.
If you select SQL Server, enter the name of the server and database and the type of authentication.
6
In the Select Storage Options dialog box, the Network Share is pre-selected (this is the best practice for backup storage). Select the backup storage destination that was created in the prerequisites procedure (Installing Quest GPOADmin ) and click Next.
* 
NOTE: To create the GPOADmin_Backups database during the Server Configuration Wizard setup, the Service account must have Database Creator role for the specific SQL Server.
7
In the Configure Server Access dialog box, add the accounts that will be Administrators and Users.
To add an Administrator, select the icon with the Plus sign (the icon with the arrowhead will expand or collapse the list). After the account is selected, it will appear in the Administrators list. The account can be removed by selecting the red X icon.
By default the Enterprise Admins and the Service Account are added to the trustees permitted to connect to the system and change server properties. We recommend that you create a Global Group for GPOADmin Admins (<Domain>-GPOADmin Admins), add it, and click Next.
8
In the Configure Server Access dialog box, after you have added all the accounts, click Finish to commit the changes.

Updating your license

If you want to upgrade your license (for example from a trial license) or you want to change your license for any reason, you can access the license information through the server properties.

* 
NOTE: If your license expires, you will be prompted to update it the next time you attempt to connect to the service.
To update the GPOADmin license through the Server Properties
1
Select the GPOADmin node, right-click and select Connect To, and connect to the console.
2
Right-click the forest for that connection and select Options.
3
In the Options dialog expand License | Current License.
4
Check the Update License check box and browse to and select your updated license.
5
Click OK.
* 
NOTE: If your license expires, you will be prompted for the DLV file when you try to connect to the Version Control System.

Setting Permissions on AD LDS

To use GPOADmin with an AD LDS deployment, users must be assigned the Administrator role.

To set permissions on AD LDS
1
Open AD LDS ADSI-Edit (ADSI-Edit is installed as part of the AD LDS tools).
2
In the Select a well known Naming Context, select Configuration, then enter the console and port number in the Computer box, and click OK.
For example, GPOconsole:389.
3
Double-click Configuration to expand the configuration and browse to and select the Roles container.
4
To grant the users rights, right-click the Administrators role, and select Properties.
5
Browse to the member attribute and click Edit.
6
Add the service account and other accounts that will be administering GPOADmin to the selected role.
* 
NOTE: If required, you can use the AD LDS support tool dsacls to fine-tune the rights given by these roles or to grant specific rights to users.

Editing the Version Control server properties

Users logged on with an account that is a member of the GPOADmin administrators group can edit the properties of the Version Control server when required. Specifically, they can:

•
add and remove users and administrators to your GPOADmin deployment.
•
select the backup repository for the historical copies of objects.
•
create and define roles used to delegate rights over the Version Control system.
•
configure email notifications on Version Controlled events.
•
select the type of information you want to track and the location for the log files.
•
configure various properties such as GPMC version checks, workflow options for GPOs, default link state, protected settings, GPO synchronization, unique names, unregistered SOM linking, WMI filter display, and custom workflow actions.
•
configure the domain controller that GPOADmin will use for all Active Directory actions as well as whether to enforce comments to all actions and naming conventions for newly created objects.
•
view or update the current license.
•
select product integration options.
•
enable support for Microsoft Intune.
•
enable FIPS mode.
To edit the Version Control Server configuration
* 
NOTE: You must use the GPOADmin console to edit server configuration, not the GPMC Extension.
1
Right-click the forest, and select Options.
2
Select Access to add and remove users who can connect to and alter the Version Control server options.
Select Administrators and add/remove users who can connect to and alter the Version Control server-specific settings.
Select Users and add/remove users who can connect to the Version Control server, but can only perform those actions that have been assigned by an administrator.
3
Select Storage to select the location of the physical backup copy of the various versions of an object.
You can choose between:
Backup store location: This will store the backups in Active Directory if you selected it during the initial setup of GPOADmin as the storage method for your configuration.
* 
NOTE: Active Directory is not recommended for production deployments due to the amount of replication data.
AD LDS: This will store the backups in Active Directory Lightweight Directory Services (AD LDS).
Enter the server name and port.
* 
NOTE: To use the same AD LDS instance for both the configuration and backup store, select the “Configuration store location” option on the Backup location page.
Network Share: Enter or browse to a network share or directory.
* 
NOTE: This is the recommended method as it provides a high level of performance and a low level of configuration and maintenance overhead.
SQL Server: This will store the backups in SQL Server. Enter the database name and the required authentication.
* 
NOTE: If the server is installed as a unique instance, it must be specified as servername\instancename rather than just the SQL Server name.
4
To help optimize performance and secure your data by configuring accepted SQL input filters and timeout settings, select SQL.
a
To protect your environment from a SQL Injection attack, choose the SQL Input Filters option to specify which SQL statement inputs are not permitted within your deployment. By default, all of the inputs are marked as not permitted.
If you allow these inputs, malicious code may be inserted in a SQL statement resulting in security vulnerability.
b
Choose the SQL Timeouts option to configure how long GPOADmin will wait to connect to the SQL server or to process a command.
c
Adjust the timeout values that best fit your deployment and click OK.
The default for the connection timeout is 15 seconds and the default for the command timeout is 30 seconds.
5
Select Desired State Configuration | Root directory to specify a DSC root directory for each domain that supports DSC scripts. This root directory serves as the starting point for the DSC script enumeration and deployment location. DSC scripts cannot be registered until this option is enabled.
6
Select Scripts to set the file types that will be returned when enumerating Scripts in the live environment. Add and remove the file extensions as required and click OK.
7
Select Delegation | Roles to create and edit roles that will be used to delegate rights over the Version Control system.
The built in roles and descriptions are displayed. Add, edit, and delete roles as required.
* 
NOTE: You cannot alter predefined roles.
For complete information on creating and delegating roles, see Configuring role-based delegation in the User Guide.
8
Select Notifications to configure email notifications on Version Controlled events. Notifications help you to stay informed of the latest changes to objects under version control and can be enabled for Exchange on-premises, Office 365 Exchange Online, and Gmail.
To use notifications, you must enable SMTP and set the method of authentication. The required method is dependent on the mechanism selected to send notifications.
•
When using Exchange on-premises, basic authentication is required.
•
When using Office 365 Exchange Online, OAuth 2.0 authentication is required.
•
When using Gmail a credential file is required.

 

Table 3. SMTP options
Option
Procedure

Select SMTP to modify the global SMTP notification options.

.

NOTE:  
•
Users can alter the email address for their notification email through their personal settings, or through the Notification Manager. See the User Guide for details.)
•
GPOADmin supports TLS/SSL connections. When connecting to Office 365 for standard SMTP notifications, the  From  account must be a valid email address and have access to the mailbox of the authentication account.
•
To ensure secure communication between GPOADmin and your Exchange server, it is recommended that your Exchange server be configured to support TLS 1.2.
•
If you select to use Gmail, a folder directory is created in the location of the credential file which contains a tokens.json response folder and a corresponding token response file. This file is no longer required once the activation has been processed and can be safely removed.
•
If you want to use Microsoft Azure GCC High email for notifications, select the U.S Government GCC High option. For information on using Exchange Online for US Government environments refer to Microsoft documentation.

 
1
Select Basic to use Exchange for notifications.
a
Select to Enabled SMTP notifications.
b
Enter the SMTP server.
c
Enter the port number. 25 for standard, unencrypted communication, 465 for older SSL communication, or 587 for TLS communications.
d
Enter a “From” address. If your SMTP server is not configured for anonymous connections, enter the associated credentials.
e
You can optionally select to attach read and/or delivery receipts with notifications. Once enabled, the email specified in the “From” address can confirm that notifications are received and/or read after they are sent.
2
Select Exchange Online to use Office 365 Exchange Online for notifications.
a
Select to Enabled SMTP notifications via Exchange.
b
Enter the application Id, tenant Id, client secret key, and https://outlook.office365.com/ews/exchange.asmx as the Exchange Server Url.
The application ID, tenant ID, and client secret key are set when you register GPOADmin to use Office 365 Exchange Online through Azure Active Directory. See the User Guide appendix Registering GPOADmin for Office 365 Exchange Online for details.
3
Select Gmail to use Google mail for notifications.
a
Select to Enabled SMTP notifications via Gmail.
b
Enter the Gmail account.
c
Enter the credential file location. (To use Gmail, users must generate this credentials file from Gmail. GPOADmin uses this file to connect to Gmail, verify the authorization, get access and refresh tokens to retrieve and send messages.) See the User Guide appendix Configuring Gmail for Notifications for information on creating this file.
d
To navigate past the application verification warning, click Advanced and then click the Go to GPOAdmin (unsafe) link.
e
Grant GPOAdmin permissions to View and modify but not delete your email.
f
Click Allow to confirm your selection.
Table 4. Workflow notification options
Option
Procedure

Select Workflow to enable workflow approval through email, set the authentication method, and modify the mailbox and server information.

NOTE:  
•
The Exchange option supports at a minimum Microsoft Exchange 2010 for on-premises mailboxes and Office 365 Exchange Online.
•
All approvers and the service account must have a valid Exchange on-premises or Office 365 Exchange Online inbox.
•
Distribution lists should be used for approval groups.
•
Proper Exchange certificates must be installed on the GPOADmin server if certificates are being used in your Exchange environment.
•
You must restart the GPOADmin service when you enable or disable this option.
•
If you select to use Gmail, a folder directory is created in the location of the credential file which contains a tokens.json response folder and a corresponding token response file. This file is no longer required once the activation has been processed and can be safely removed.
•
If you want to use Microsoft Azure GCC High email for approvals, select the U.S Government GCC High option. For information on using Exchange Online for US Government environments refer to Microsoft documentation. This option is only available for OAuth 2.0 Authentication.

 
1
Select Exchange to use Exchange or Exchange Online for notifications.
a
Select Enable Workflow Approval through email.
b
Set the required authentication.
To use Exchange for notifications, select Basic and enter the account to use to connect to the mailbox and password. Enter the Exchange Server Url or select Autodiscover Exchange Server Url to locate the Exchange server that is hosting the specified mailbox.
By default, GPOADmin uses the mailbox associated with the service account. If necessary, you can specify a different mailbox for the service to use when processing approvals and rejections through email. To do so, uncheck the Use the service accounts mailbox option and enter the mailbox that you want to the service to monitor. To connect as the service, leave the account blank and password blank.
To use Office 365 Exchange Online for notifications, select Exchange Online. Enter the mailbox. application Id, tenant Id, client secret key, and https://outlook.office365.com/ews/exchange.asmx as the Exchange Server Url.
(The application ID, tenant ID, and client secret key are set when you register GPOADmin to use Office 365 Exchange Online through Azure Active Directory. See the User Guide Appendix: Registering GPOADmin for Office 365 Exchange Online for details.)
2
Select Gmail to use Google mail for notifications.
a
Select to Enabled SMTP notifications via Gmail.
b
Enter the Gmail account.
c
Enter the credential file location. (To use Gmail, users must generate this credentials file from Gmail. GPOADmin uses this file to connect to Gmail, verify the authorization, get access and refresh tokens to retrieve and send messages.) See the User Guide Appendix: Configuring Gmail for Notifications for information on creating this file.
d
To navigate past the application verification warning, click Advanced and then click the Go to GPOAdmin (unsafe) link.
e
Grant GPOAdmin permissions to View and modify but not delete your email.
f
Click Allow to confirm your selection.
9
Select Logging | Configuration to enter the log location and the type of information you want to track.
You can choose to log to the Event Log, to a specific directory where log files will be created, or not at all.
You can also select which (if any) types of events to log. The types of events are as follows: Service Actions (such as service startup and shutdown), User Actions (such as check in, approve, edit), Errors, and Debug Information (used by Quest support personnel).
10
Select Options to configure various settings.
Select General to configure the following options:
Table 5. General options
Option
Description

Perform Group Policy Management version check

Check to ensure the version of GPMC on the client is compatible with the GPMC version used within GPOADmin.

Disable all workflow options for Group Policy Objects

Disable all workflow on GPOs.

Keep in mind, if you disable the workflow, any changes made are immediately deployed in the live environment. To bring the GPO back under version control, enable the workflow.

Disable all workflow options for Scopes of Management

Disable all workflow on SOMs.

Keep in mind, if you disable the workflow, any changes made are immediately deployed in the live environment. To bring the SOM back under version control, enable the workflow.

Disable all workflow options for WMI Filters

Disable all workflow on WMI filters.

Keep in mind, if you disable the workflow, any changes made are immediately deployed in the live environment. To bring the WMI filter back under version control, enable the workflow.

Set default link state to enable when adding new links

This enables the default link state for any new links added to a SOM.

Enable Protected Settings for Group Policy Objects

This enables the ability to have Protected Settings policies that contain settings that you want to control. They are protected in the sense that they contain and identify the settings that cannot 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.

Enable Group Policy Object Synchronization

Synchronizing GPOs allows you to automatically push out predefined GPO settings to specified targets both within a forest and between two forests. This allows you to ensure specific GPOs, which are required in every domain, contain the same settings without having to link to a GPO outside of the domain.

You are able to select one or more GPOs from various domains as synchronization targets for the source GPO. When the source GPO has been successfully deployed, the settings from the last major backup are imported into each synchronization target GPO.

Allow the service account to synchronize Group Policy Objects during deployment

Provides the ability to control whether the service account can perform a GPO synchronization during deployment.

•
If disabled, a GPO synchronization will only happen during deployment if the deploying account has the Synchronization right on the GPO.
•
If enabled, the service account will perform a GPO synchronization during deployment. (Default)

Enable Unique Name

This ensures that GPOs and WMI filters cannot be created with the same name as an existing GPOs or WMI filter in a domain, select the Enforce Unique Names option. If a non-deployed GPO indicates that a duplicate name exists, run a full compliance check to determine if any GPOs were modified outside of GPOADmin.

Enable Unique Role Names

This ensures that roles cannot be created with the same name as an existing role.

Enable unregistered Scopes of Management linking

To allows users to link to unregistered Scopes of Management, select the Enable unregistered Scope of Management linking option. If this option is not selected, the policy and the SOM must be registered and the user linking the policy must have the Link right on both objects.

Display only the WMI Filters a user has Read access to when editing a GPO

Users are restricted to only the WMI Filters they have Read access.

Ensure service account access prior to deployment

This option must be enabled if you want users to be able to automatically deploy an object’s associated items.

It ensures that the service account has the Edit settings, delete, modify security rights on the working copy before deployment.

Enable the identification of associated items during deployment

Provides users with the option to identify and deploy associated items in a pending deployment state.

Prevent approval requester from approving their own changes

Ensures that a user cannot approve their own changes, even if they are in the approver's list for the object.

Enable the processing of custom workflow actions

Clicking the Launch Editor button starts the Custom Workflow Editor.

OU display format

Set the display format for OUs.

Select SQL Input Filters to view the allowed strings and characters for SQL statements.
* 
NOTE: To protect your environment from a SQL Injection attack, you can mark which SQL statement inputs are not permitted. If you allow these inputs, malicious code may be inserted in a SQL statement resulting in security vulnerabilities.
Select Comments to enforce comments to all actions and naming conventions for newly created objects. Set a minimum comment length greater than 0. Leaving the value at 0 means comments are optional for all actions. Any value greater than zero makes comments mandatory for all actions and all users.
Select Deployment Failure to enable an automatic retry on failed deployments. Enable the option and select the number of attempts (maximum of 10) and the interval in minutes (maximum of 1440). Re-deployment attempts are done as scheduled deployments.
Select Preferred Domain Controllers and click Add to configure the domain controller that GPOADmin will use for all Active Directory actions. By default, GPOADmin uses the Primary Domain Controller.
Select Backups Retention to configure a retention schedule for backups. You can select to limit the backups to keep based on a specified number, age, or date. Backup retention settings apply to SQL configuration stores only.
* 
NOTE: All backups generated by the watcher service due to non-compliance are counted in the retention limit.
11
Select License | Current License to view the current license information.
Select the Update License check box and then click Browse and go to the new license location.
12
Select Intune | Configuration to enable support for Intune and enter the information to connect to the required Azure Active Directory tenant. This includes the application ID, tenant ID, tenant name, and client secret for the tenant where Intune is installed. See the Minimum permissions, rights, and roles required for Microsoft Intune.
13
Select Integration to configure settings that apply to a Quest Change Auditor™ integration.
If you have multiple Change Auditor coordinators installed, you can select a specific coordinator to use for reports and auditing.
If necessary, you can also select to turn off Change Auditor, by selecting Not Set.
14
Select Enable FIPS Mode. The Federal Information Processing Standards (FIPS) are government set guidelines and standards published by the National Institute of Standards and Technology. To run a Windows environment in FIPS compliant mode, the Microsoft Policy “System cryptography: Use FIPS compliant algorithms for encryption, hashing, and signing” must be enabled.
Select Enable FIPS mode to ensures that GPOADmin uses cryptographic algorithms that are FIPS compliant.
Select Allow self-signed certificates when communicating with Exchange servers if required.
Both these options are enabled by default.
15
When you have made all the required selections, click OK
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating