Retrieves a list of service accounts registered with the Data Governance server.
Syntax:
Get-QServiceAccounts [-ServiceAccountId] [<String>]] [<CommonParameters>]
| Parameter | Description |
|---|---|
| ServiceAccountId |
(Optional) Specify the ID (GUID format) of the service account to be retrieved. Run the Get-QManagedDomains cmdlet to retrieve a list of managed domains, including the managed domain and service account IDs. |
Examples:
| Example | Description |
|---|---|
| Get-QServiceAccounts |
Retrieves a list of all registered service accounts. |
| Get-QServiceAccounts -ServiceAccountId 3253af66-c104-4472-b770-c8097b2df6d8 | Retrieves information about the specified service account. |
Details retrieved:
| Detail | Description (Associated key or property in QAMServiceAccount table) |
|---|---|
| ServiceAccountId | The value (GUID) assigned to the service account (UID_QAMServiceAccount). |
| AccountSid | The security identifier (SID) assigned to the Active Directory account. |
| UserDomainName | The name of the domain to which the user belongs. |
| UserName | Logon name (pre-Windows 2000) of the Active Directory account (UID_ADSAccount). |
| UserPrincipalName | User principal name (email address) of the service account. |
| Description | The descriptive text entered when the service account was registered with Data Governance Edition. |
| IsDefaultObjectResolution | Indicates whether the account is being used as the Data Governance default account and will be used to connect to Active Directories which do not have explicit service accounts configured. |
| StatusDetailMessage | If applicable, a message about the current state of the data from the agent. |
| Status | The status of the agent. |
| CanManageDomains |
Indicates whether the service account is capable of being impersonated on the Management Server it is being called upon. NOTE: This is set within the ServiceAccounts InternalService on the Data Governance server. It will be true if impersonation is successful; and false, if impersonation fails. |
| ServiceAccountName | The name of the service account. |