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>]
Parameter | Description |
---|---|
AgentId |
Specify the ID (GUID format) of the agent whose stored messages are to be retrieved. Run the Get-QManagedHosts cmdlet and locate the agents array in the managed host to retrieve its ID. |
Examples:
Example | Description |
---|---|
C:\PS>@{#cdata-section=Add-PSSnapin Quest.DataGovernance 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:
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. |