Uninstall-SCOMAgent
从代理管理的计算机中卸载代理。
语法
Default （默认值）
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。
参数属性
| 类型: | PSCredential |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Agent
指定 AgentManagedComputer 对象的数组。 此参数指定要卸载的 Operations Manager 代理。 若要获取 AgentManagedComputer 对象，请使用 Get-SCOMADAgent cmdlet。
参数属性
| 类型: | AgentManagedComputer[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Confirm
在运行 cmdlet 之前，提示你进行确认。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-PassThru
指示 cmdlet 创建或修改命令可以在管道中使用的对象。 默认情况下，此 cmdlet 不生成任何输出。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-WhatIf
显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 无线 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。