B.2 Get Object

Initiate instance of an object, such as a GPO, category, or domain, in the GP Repository. The object should exist in the GP Repository.

B.2.1 Repository Object Path

The Repository object path is the location of a node for a GPO, category, or domain in the GP Repository. The format for the Repository object path is similar to an LDAP path with the following exceptions:

  • Use faGPR:// for the GP Repository path instead of LDAP://.

  • Category names are preceded by CN= and each element of the domain name is preceded by DC=.

The simplest method for viewing the Repository object path is to right‑click the node for the appropriate GPO, category, or domain, and then click Properties. Use the Path property.

B.2.2 Syntax

Get-GPRObject [-FAGPRPath] <String>

Parameter

Value

FAGPRPath

The FAGPRPath of the Repository object.

NOTE:To see the complete list of available properties, run Get-Member on the object returned from the Get-GPRObject command.

Sample Code 1

NOTE:Before executing this cmdlet, run Set-GPRConnection to establish a connection to the GPA Repository database. See the PowerShell cmdlet sample for more information.

The following sample gets the NetIQLabs.com domain GPR object for the specified FAGPRPath.

PS C:\>Get-GPRObject  -FAGPRPath "FAGPR://DC=NetIQLabs,DC=com"

Sample Code 2

NOTE:Before executing this cmdlet, run Set-GPRConnection to establish a connection to the GPA Repository database. See the PowerShell cmdlet sample for more information.

The following sample gets the desktop category GPR object for the specified FAGPRPath.

PS C:\>Get-GPRObject -FAGPRPath "FAGPR://CN=Desktop,DC=NetIQLabs,DC=com"

Sample Code 3

NOTE:Before executing this cmdlet, run Set-GPRConnection to establish a connection to the GPA Repository database. See the PowerShell cmdlet sample for more information.

The following sample gets the GPO GPR object for the specified FAGPRPath.

PS C:\>Get-GPRObject -FAGPRPath "FAGPR://CN={31B2F340-016D-11D2-945F-00C04FB984F9},CN=Desktop,DC=NetIQLabs,DC=com"