Add-QManagedDomain
Adds a new domain to the Data Governance Edition deployment.
The Data Governance server constructs an in-memory map of the Active Directory forest and domain structure where it is deployed. Administrators responsible for the Data Governance Edition deployment must register Service Accounts with the system and link them with domains. The link between a Service Account and an Active Directory domain makes it a "managed domain".
Note: Only domains that have been previously synchronized into the One Identity Manager database are available to be managed by Data Governance Edition.
Syntax:
Add-QManagedDomain [-ServiceAccountID] <String> [-DomainName] <String> [<CommonParameters>]
Table 136: Parameters
| ServiceAccountID |
Specify the ID (GUID format) of the service account that will manage the domain.
Run the Get-QServiceAccounts cmdlet to retrieve a list of all service accounts registered with your Data Governance Edition deployment. |
| DomainName |
Specify the DNS name of the domain to be added as a managed domain. |
Examples:
Table 137: Examples
| Add-QManagedDomain -ServiceAccountID 7dd2eb51-e1cb-47f2-8c76-093fd4e0459e -DomainName mydomain.local |
Adds a new managed domain. |
Get-QManagedDomains
Retrieves information, including the service account and managed domain IDs, for a managed domain from the Data Governance Edition deployment.
Syntax:
Get-QManagedDomains [-ManagedDomainId [<String>]] [<CommonParameters>]
Table 138: Parameters
| ManagedDomainId |
(Optional) Specify the ID (GUID format) of the managed domain to be retrieved. |
Examples:
Table 139: Examples
| Get-QManagedDomains |
Returns all managed domains in the database. |
| Get-QManagedDomains -ManagedDomainId 50905871-5379-455d-8b65-c4bd02360bdb |
Returns information on the specified managed domain. |
Details retrieved:
Table 140: Details retrieved
| ManagedDomainID |
The value (GUID) assigned to the managed domain. (UID_ADSDomain) |
| DomainDnsName |
The full DNS name of the managed domain. (ADSDomainName) |
| ForestDnsName |
The full DNS name of the forest where the domain resides. (UID_ADSForest) |
| Status |
The status of the managed host, based on all the agents monitoring the host. |
| NetbiosName |
The Netbios name of the managed domain. |
| DomainSid |
The security identifier (SID) assigned to the managed domain. |
| ServiceAccountId |
The value (GUID) of the service account assigned to the managed domain. (UID_QAMServiceAccount) |
| AccessGroupSid |
Deprecated. |
| ServiceAccountInfo |
The name of the service account assigned to the managed domain. |
| DomainControllerName |
The name of the domain controller hosting the managed domain. |
| ExtendedRightsCreated |
Indicates whether extended rights were created by Data Governance Edition in the Active Directory environment. |
Remove-QManagedDomain
Removes a managed domain from the Data Governance Edition deployment.
Note: Remove all managed hosts associated with a managed domain BEFORE removing a managed domain. Run the Remove-QManagedHost cmdlet to remove a managed host.
Syntax:
Remove-QManagedDomain [-ManagedDomainId] <String> [<CommonParameters>]
Table 141: Parameters
| ManagedDomainId |
Specify the ID (GUID format) of the managed domain to be removed.
Run the Get-QManagedDomains cmdlet without any parameters to retrieve a list of managed domains, including the managed domain ID. |
Examples:
Table 142: Examples
|
Remove-QManagedDomain -ManagedDomainId 830b1e48-c682-4d3e-965c-d96ee6db6262 |
Removes the specified managed domain from Data Governance Edition. |
Agent deployment
The following commands are available to you to manage your agent deployment. For full parameter details and examples, click a command hyperlink in the table or see the command help, using the Get-Help command.
