Removes a managed host from the list of registered managed hosts.
Note: When unregistered, any agent instances associated with the managed host are also removed. If a computer no longer hosts any agent instances, the Data Governance agent software is also removed.
Syntax:
Remove-QManagedHost [-ManagedHostIds] <String[]> [[-DeleteDuGFirst] [<SwitchParameter>]] [[-SkipAgentUninstall] [<SwitchParameter>]] [<CommonParameters>]
Parameter | Description |
---|---|
ManagedHostIds |
Specify one or managed hosts to be deleted. If you specify multiple managed host ids, separate then with commas. Run the Get-QManagedHosts cmdlet without any parameters to retrieve a list of available managed hosts and their IDs. |
DeleteDuGFirst | (Optional) Specify this parameter if you want to remove the entry in the QAMDuG table prior to removing the specified managed hosts. |
SkipAgentUninstall | (Optional) Specify this parameter if you want to force the removal of the managed host from the One Identity Manager database, without uninstalling the managed host's agent.
If this parameter is not specified, the agent will be removed as part of the host removal process. |
Examples:
Example | Description |
---|---|
Remove-QManagedHost -ManagedHostIds A293B96E-9620-4879-8FC7-FB3393E72768 | Removes a single managed host from the Data Governance Edition deployment. |
Remove-QManagedHost -ManagedHostIds 29F1D9AD-C87A-4F82-830C-0A7CD1088D84,E4A0B8B8-F021-4509-9648-B4C313E542C0 | Removes two managed hosts from the Data Governance Edition deployment. |