Uninstall-SCOMAgent
从代理托管的计算机卸载代理。
语法
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