Chat now with support
Chat with Support

Identity Manager Data Governance Edition 8.0 - Technical Insight Guide

Introduction Data Governance Edition Network Communications Data Governance service Data Governance agents Resource activity collection in Data Governance Edition QAM module tables Configurable configuration file settings
Data Governance service configuration file settings Data Governance agent configuration file settings
Configurable registry settings PowerShell commands
Adding the PowerShell snap-ins Finding component IDs Data Governance Edition deployment Service account management Managed domain deployment Agent deployment Managed host deployment Account access management Resource access management Governed data management Classification management
About us

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 134: Parameters
Parameter Description
ManagedDomainId

(Optional) Specify the ID (GUID format) of the managed domain to be retrieved.

Examples:
Table 135: Examples
Example Description
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 136: Details retrieved
Detail Description (Associated key or property in ADSDomain table)
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 137: Parameters
Parameter Description
ManagedDomainId

Specify the ID (GUID format) of the managed domain to be removed.

 NOTE: Run the Get-QManagedDomains cmdlet without any parameters to retrieve a list of managed domains, including the managed domain ID.
Examples:
Table 138: Examples
Example Description

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.

Table 139: Agent deployment commands

Use this command

If you want to

Get-QAgentEvents

View saved events for the specified agent from the One Identity Manager database. You can use this command to output the stored agent messages to the console or a text file to quickly identify issues.

For more information, see Get-QAgentEvents.

Get-QAgentMetrics

View an agent’s activity and performance.

For more information, see Get-QAgentMetrics.

Set-QAgentConfiguration

Set the managed paths to be scanned.

 NOTE: When you set the managed paths using the cmdlet, existing managed paths are overwritten.

 NOTE: This cmdlet does not support setting managed paths for Cloud managed hosts.

For more information, see Set-QAgentConfiguration.

Set-QAgentStateUpdated

Notify the Data Governance server that an agent has been updated and the server should process it.

For more information, see Set-QAgentStateUpdated.

Upgrade-QAgents

Upgrade the agents in your deployment.

NOTE: You can identify the agents to upgrade through their agent ID or on a managed host basis.

For more information, see Upgrade-QAgents.

Get-QAgentEvents

Retrieves saved events for the specified agent from the One Identity Manager database.

Agent events include information such as errors and warnings from the agent that are stored in the One Identity Manager database. Use this command to retrieve stored agent messages to the console or a text file to quickly identify issues.

Syntax:

Get-QAgentEvents [-AgentId] <String> [<CommonParameters>]

Table 140: Parameters
Parameter Description
AgentId

Specify the ID (GUID format) of the agent whose stored messages are to be retrieved.

 NOTE: Run the Get-QManagedHosts cmdlet and locate the agents array in the managed host to retrieve its ID.
Examples:
Table 141: Examples
Example Description

C:\PS>@{#cdata-section=Add-PSSnapin Quest.DataGovernance
$hosts = Get-QManagedHosts
$agents = $hosts[0].Agents
$agentId = $agents[0].Id

Get-QAgentEvents -AgentId $agentId; xmlns:dev=http://schemas.microsoft.com/maml/dev/2004/10}

First run the Get-QManagedHosts command and access the agents collection for the selected managed host. Locate the agent ID, call Get-QAgentEvents, and pass the agent ID to the method.

 Returns all stored messages for the specified Data Governance agent.
Details retrieved:
Table 142: Details retrieved
Detail Description (Associated key or property in QAMAgentEvent table)
Date/Time The date and time the critical agent error occurred.
Description The event message logged for the critical agent error.
Related Documents