Initiate instance of an object, such as a GPO, category, or domain, in the GP Repository. The object should exist in the GP Repository.
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.
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. |
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"
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"
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"