Uninstall-SCXAgent
卸载指定托管 UNIX 和 Linux 计算机上的管理代理。
语法
Uninstall-SCXAgent
-Agent <IPersistedUnixComputer[]>
[-SshCredential <CredentialSet>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]说明
Uninstall-SCXAgent cmdlet 在指定的 UNIX 和 Linux 计算机上卸载管理代理。
必需的 Agent 参数指定要卸载的目标托管 UNIX 或 Linux 计算机，并且需要 UNIX 或 Linux 计算机对象。 有关检索托管 UNIX 或 Linux 计算机的信息，请参阅 Get-SCXAgent cmdlet。 可以指定可选的 SSHCredential 参数来标识用于卸载管理代理的特权凭据。 如果未指定 SSHCredential ，则 cmdlet 会尝试为代理使用定义的特权运行方式帐户。
此 cmdlet 不返回任何输出。
示例
示例 1：卸载管理代理
PS C:\>$Agent01 = Get-SCXAgent -Name "nx1.contoso.com"
PS C:\> $SSHCredential = Get-SCXSSHCredential -UserName "DavidChew" -Key "C:\keys\key21.ppk" -ElevationType sudo
PS C:\> Uninstall-SCXAgent -SSHCredential $SSHCredential -Agent $Agent01第一个命令使用 Get-SCXAgent cmdlet 获取名为 nx1.contoso.com 的托管 Linux 或 UNIX 计算机的代理。 此命令将其存储在 $Agent 01 变量中。
第二个命令使用 Get-SCXSSHCredential cmdlet 为用户创建特权凭据。 此命令将结果存储在$SSHCredential变量中。
最后一个命令使用指定的 SSH 凭据卸载 $Agent 01 中的管理代理。
示例 2：使用定义的运行方式帐户卸载管理代理
PS C:\>Get-SCXAgent -Name "nx1.contoso.com" | Uninstall-SCXAgent此命令使用 Get-SCXAgent 获取名为 nx1.contoso.com 的托管 Linux 或 UNIX 计算机的代理。 此命令将托管计算机传递到当前 cmdlet。 该命令使用定义的运行方式帐户卸载管理代理。
参数
-Agent
指定一个或多个托管 UNIX 或 Linux 计算机对象。
有关如何获取托管 UNIX 或 Linux 计算机对象的信息，请键入 Get-Help Get-SCXAgent。
| Type: | IPersistedUnixComputer[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ComputerName
指定计算机的名称数组。 该 cmdlet 与这些计算机的管理组建立临时连接。 可以使用 NetBIOS 名称、IP 地址或完全限定的域名 (FQDN) 。 若要指定本地计算机，请键入该计算机名称、localhost 或句点 (.)。
System Center Data Access 服务必须在计算机上处于活动状态。 如果未指定计算机，cmdlet 将使用计算机进行当前管理组连接。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| 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 |
-Credential
指定管理组连接运行所在的用户帐户。
为此参数指定 PSCredential 对象，例如 Get-Credential cmdlet 返回的对象。
有关凭据对象的详细信息，请键入 Get-Help Get-Credential。
如果在 ComputerName 参数中指定计算机，请使用有权访问该计算机的帐户。 默认为当前用户。
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SCSession
指定 Connection 对象的数组。 若要获取 Connection 对象，请使用 Get-SCOMManagementGroupConnection cmdlet。
如果未指定此参数，cmdlet 将使用与管理组的活动持久连接。
使用 SCSession 参数指定不同的持久连接。
可以使用 ComputerName 和 Credential 参数创建与管理组的临时连接。
要了解详情，请键入 Get-Help about_OpsMgr_Connections。
| Type: | Connection[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SshCredential
指定用于执行代理维护操作的特权 SSH 凭据。 如果未指定此参数，cmdlet 将尝试使用代理定义的代理维护运行方式帐户。
有关如何获取 SSH 凭据对象的信息，请键入 Get-Help Get-SCXSSHCredential。
| Type: | CredentialSet |
| 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 |
输出
此 cmdlet 返回结果，表示计算机的卸载状态。 结果包含以下信息：
- 主机名
- 卸载状态
- 说明
说明包括卸载失败的原因的详细信息。