Uninstall-SCXAgent
在指定的托管 UNIX 和 Linux 计算机上卸载管理代理。
语法
Uninstall-SCXAgent
-Agent <IPersistedUnixComputer[]>
[-SshCredential <CredentialSet>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]说明
Uninstall-SCXAgent cmdlet 在指定的 UNIX 和 Linux 计算机上卸载管理代理。
所需的 代理 参数指定要卸载的目标托管 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。
| 类型: | IPersistedUnixComputer[] |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-ComputerName
指定计算机名称数组。 该 cmdlet 与这些计算机的管理组建立临时连接。 可以使用 NetBIOS 名称、IP 地址或完全限定的域名（FQDN）。 若要指定本地计算机，请键入计算机名称、localhost 或点（.）。
System Center Data Access 服务必须在计算机上处于活动状态。 如果未指定计算机，该 cmdlet 将使用计算机进行当前管理组连接。
| 类型: | String[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Confirm
在运行 cmdlet 之前，提示你进行确认。
| 类型: | SwitchParameter |
| 别名: | cf |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Credential
指定运行管理组连接的用户帐户。
为此参数指定 PSCredential 对象，例如 Get-Credential cmdlet 返回的对象。
有关凭据对象的详细信息，请键入 Get-Help Get-Credential。
如果在 ComputerName 参数中指定计算机，请使用有权访问该计算机的帐户。 默认值为当前用户。
| 类型: | PSCredential |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SCSession
指定 连接 对象的数组。 若要获取 连接 对象，请使用 Get-SCOMManagementGroupConnection cmdlet。
如果未指定此参数，cmdlet 将使用与管理组的活动持久连接。
使用 SCSession 参数指定不同的持久连接。
可以使用 ComputerName 和 Credential 参数创建与管理组的临时连接。
有关详细信息，请键入 Get-Help about_OpsMgr_Connections。
| 类型: | Connection[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SshCredential
指定用于执行代理维护操作的特权 SSH 凭据。 如果未指定此参数，cmdlet 将尝试为代理使用定义的代理维护运行方式帐户。
有关如何获取 SSH 凭据对象的信息，请键入 Get-Help Get-SCXSSHCredential。
| 类型: | CredentialSet |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-WhatIf
显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。
| 类型: | SwitchParameter |
| 别名: | wi |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输出
此 cmdlet 返回结果，这些结果表示计算机的卸载状态。 结果包含以下信息：
- 主机名
- 卸载状态
- 描述
说明包括卸载失败的原因的详细信息。