Beginning with GPOADmin 5.22, the ServerInstance parameter was introduced and is now required when configuring the product through PowerShell. This has caused confusion for environments using a SQL Configuration Store, as the parameter only accepts ActiveDirectory or ADLDS and does not appear to support SQL Server values.
Although the parameter name may imply a SQL Server instance, ServerInstance does not refer to SQL Server. Instead, it identifies the directory service instance used by GPOADmin for authentication and object registration.
When reviewing the Set-Configuration cmdlet in GPOADmin 5.22:
-ServerInstance parameter is mandatory.ActiveDirectoryADLDSThe confusion stems from the name of the parameter.
The ServerInstance parameter does not identify the SQL Server hosting the Configuration Store database. Instead, it specifies the directory service type used by GPOADmin.
Quest introduced this parameter in version 5.22 to support enhancements related to:
As a result, the parameter is mandatory regardless of the storage mode being used.
When using a SQL Configuration Store, continue to configure SQL settings using the SQL-specific parameters. The ServerInstance parameter should still be set to the directory service type being used in the environment.
| Component | Store Type | Configuration Parameters |
|---|---|---|
| Configuration Store | SQL Server | -StorageMode SQL, -SqlServer, -SqlDatabase |
| Backup Store | Network Share | -BackupServer "\\server\share" |
| Directory Service Instance | Active Directory or ADLDS | -ServerInstance ActiveDirectory or -ServerInstance ADLDS |