通过

Uninstall-SCOMAgent

  • 参考
模块:
OperationsManager

从代理托管的计算机卸载代理。

语法

Uninstall-SCOMAgent
         [-ActionAccount <PSCredential>]
         -Agent <AgentManagedComputer[]>
         [-PassThru]
         [-WhatIf]
         [-Confirm]
         [<CommonParameters>]

说明

Uninstall-SCOMAgent cmdlet 从代理管理的计算机上卸载代理。 卸载代理之前，必须从管理组中删除Active Directory 域服务 (AD DS) 代理分配。 可以使用 Remove-SCOMADAgentAssignment cmdet 从管理组中删除 AD DS 代理分配。

示例

示例 1：卸载代理

PS C:\>Get-SCOMAgent -DNSHostName "server01.contoso.com" | Uninstall-SCOMAgent

第一个命令获取名为 server01.contoso.com 的 Operations Manager 代理对象，并使用管道运算符将其传递给 Uninstall-SCOMAgent cmdlet。 第二个命令卸载名为 server01.contoso.com 的代理。

示例 2：使用对象变量卸载代理

PS C:\>$Agent = Get-SCOMAgent -DNSHostName "server01.contoso.com"
PS C:\> Uninstall-SCOMAgent -Agent $Agent

此示例在代理管理的计算机上卸载 Operations Manager 代理。

第一个命令获取名为 server01.contoso.com 的代理管理的计算机对象，并将对象存储在$Agent变量中。

第二个命令卸载存储在$Agent中的代理。

示例 3：使用操作帐户卸载代理

PS C:\>$Agent = Get-SCOMAgent -DNSHostName "server01.contoso.com"
PS C:\> Uninstall-SCOMAgent -Agent $Agent -ActionAccount (Get-Credential)

本示例在用户输入 Operations Manager 卸载代理所需的凭据后，在代理托管计算机上卸载 Operations Manager 代理。

第一个命令获取名为 server01.contoso.com 的代理对象，并将对象存储在$Agent变量中。

第二个命令提示用户输入 Operations Manager 用于卸载代理的凭据。 然后，该命令将卸载存储在$Agent中的代理。

参数

-ActionAccount

指定 PSCredential 对象。 此参数指定 Operations Manager 用于运行部署任务的凭据。 如果未指定此参数或指定 null 值，Operations Manager 将使用代理管理服务器的默认操作帐户。

若要获取 PSCredential 对象，请使用 Get-Credential cmdlet。 要了解详情，请键入 Get-Help Get-Credential。

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Agent

指定 AgentManagedComputer 对象的数组。 此参数指定要卸载的 Operations Manager 代理。 若要获取 AgentManagedComputer 对象，请使用 Get-SCOMADAgent cmdlet。

Type:AgentManagedComputer[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

提示你在运行 cmdlet 之前进行确认。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

指示该 cmdlet 创建或修改命令可以在管道中使用的对象。 默认情况下，此 cmdlet 将不产生任何输出。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

显示在此 cmdlet 运行的情况下将会发生什么。 此 cmdlet 未运行。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

输入

Microsoft.EnterpriseManagement.Administration.AgentManagedComputer

输出

Microsoft.EnterpriseManagement.Administration.AgentTaskResult