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

Using the GPOADmin PowerShell commands (Examples)

The following examples show how to apply PowerShell commands to perform many of the GPOADmin functions. The commands are especially beneficial in environments where repetitive processes are required.

* 
NOTE: All the example commands can be copied word for word and run in the PowerShell window.
* 
NOTE: Some commands may appear more than once in these examples and not all GPOADmin commands are included in the examples in this guide.
* 
NOTE: The examples are based on the commands available in GPOADmin version 5.11 and later. While most of these examples are valid for GPOADmin 5.x, the command names may have changed.

Example commands are included for the following:

•
Loading the GPOADmin modules
•
Extracting help for GPOADmin commands
•
Managing objects
•
Gathering object and GPOADmin information
•
Utility commands
•
Administrative commands
•
Protected Settings commands

The ability to use a command is related to the role and user running it. For example, if the user has the User role then the commands they can run are limited to the actions associated with the s assigned to this role. This ensures that workflow, security, and protection are maintained with the commands.

For details on what is available for each role, see Configuring role-based delegation.

Before you can use the examples, you must ensure that you have registered the commands. See Registering the GPOADmin PowerShell commands .

Loading the GPOADmin modules

Rather than having to remember the module names each time you want to run a command, you can use the following simplify the process.

To load the GPOADmin module
1
On the system where GPOADmin is installed, open PowerShell.
2
To ensure the PowerShell scripts can be run, set the registry value using the following command:
Set-Executionpolicy RemoteSigned
3
Next create a PowerShell profile file, with the following command:
New-Item -path $profile -type file –force
4
Now you are going to put something into the profile file. Enter:

notepad $profile
This opens the profile file in Notepad so you can enter the following commands:
import-module ‘C:\Program Files\Quest\GPOADmin\GPOADmin.psd1’
CD VCRoot:
get-command -module GPOADmin
The first line adds the module, the second changes to the Version Control Root drive used by GPOADmin, and the last one give you a list of all available GPOADmin commands.
5
Save the profile by selecting to save and exit Notepad.
6
Exit or close PowerShell, then open it again.
The profile loads and displays a list of commands.

Extracting help for GPOADmin commands

The following code first gets all the GPOADmin commands, then creates an output file. The Get-Help command is run for each command with the –Full parameter set to return all help information. Finally, the help is written into the file along with a line used to separate the help for each command. This process continues until all the help is read for the commands.

* 
NOTE: You can run this in a script or in the PowerShell window.
To extract the help for the GPOADmin commands
1
On the system where GPOADmin is installed, open a PowerShell window.
2
Copy the following code and paste it into Notepad to remove any hidden characters.
Ensure that you copy everything from the $ (dollar sign) to the last } (closing bracket).
$x = get-command -Module GPOADmin
$file = "c:\PowerShell-Help-GPOADmin.txt"
foreach ($y in $x)
{
$y.Name.ToUpperInvariant() >> $file
"" >> $file
get-help -Full $y.Name >> $file
"" >> $file
 
"************************************************************************************************" >> $file
"" >> $file
}
3
Copy the code from Notepad and paste it into the PowerShell command line, and press Enter.
If you see >>, press Enter again.

Managing objects

The examples in this section include GPOADmin commands used for the day-to-day operations required to manage objects.

•
Get information on all GPOs
•
Get information for all managed objects
•
Get unregistered objects
•
Register an object
•
Check out an object
•
Check in an object
•
Undo the check out of an object
•
Request approval for changes
•
Withdraw an approval request
•
Approve changes
•
Reject changes
•
Withdraw approval on an object
•
Deploy an object
•
Deploy an object at a future time and date
•
Check for pending deployments
•
Cancel pending deployment

 

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating