Update-SCXAgent

参考

模块:: OperationsManager

将指定 UNIX 和 Linux 计算机上的管理代理升级到可用的最新版本。

语法

Update-SCXAgent
      -Agent <IPersistedUnixComputer[]>
      [-WsManCredential <PSCredential>]
      [-SshCredential <CredentialSet>]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

说明

Update-SCXAgent cmdlet 将指定计算机上的代理更新为可用的最新版本。如果管理代理的最新可用版本已安装目标计算机，则不执行任何操作。

所需的代理参数指定要卸载的目标托管 UNIX 和 Linux 计算机，并且需要 UNIX 和 Linux 计算机对象。有关检索托管 UNIX 和 Linux 计算机的信息，请参阅 Get-SCXAgent cmdlet。此 cmdlet 接受 SshCredential 和 WsManCredential 输入参数。提供的 SshCredential 参数用于特权代理更新操作，而提供的 WsManCredential 则用于低特权代理通信。如果未提供 SshCredential 参数，则 cmdlet 会尝试使用与目标计算机关联的已定义的代理维护运行方式帐户。

此 cmdlet 的输出是一组托管 UNIX 或 Linux 计算机对象，表示已成功更新的目标系统。

示例

示例 1：更新管理代理

PS C:\>$Agent01 = Get-SCXAgent -Name "nx1.contoso.com"
PS C:\> $WSCredential = Get-Credential "DavidChew"
PS C:\> $SSHCredential = Get-SCXSSHCredential -UserName "DavidChew" -Key "C:\keys\key21.ppk" -ElevationType sudo
PS C:\> Update-SCXAgent -SSHCredential $SSHCredential -WSManCredential $WSCredential -Agent $Agent01

第一个命令使用 Get-SCXAgent cmdlet 获取名为 nx1.contoso.com 的托管 Linux 或 UNIX 计算机的代理。该命令将其存储在 $Agent 01 变量中。

第二个命令使用 Get-Credential cmdlet 获取用户的凭据。该命令会提示你进行身份验证，然后将结果存储在$WSCredential变量中。

第三个命令使用 Get-SCXSSHCredential cmdlet 为用户创建特权凭据。该命令将结果存储在$SSHCredential变量中。

最后一个命令使用第二和第三个命令中的值更新 $Agent 01 中的管理代理。

示例 2：使用定义的运行方式帐户更新管理代理

PS C:\>Get-SCXAgent -Name "nx1.contoso.com" | Update-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

指定用于执行代理更新操作的特权 SshCredential 参数。如果未指定此参数，cmdlet 将尝试为代理使用定义的代理维护运行方式帐户。

有关如何获取 SSH 凭据对象的信息，请键入 Get-Help Get-SCXSSHCredential。

类型:	CredentialSet
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-WsManCredential

指定用于通过 WSMan 进行低特权代理通信的凭据。此 cmdlet 使用此凭据来验证代理可用性。

键入用户名（如 User01）或输入 PSCredential 对象，例如 Get-Credential cmdlet 返回的用户名。键入用户名时，系统会提示输入密码。

类型:	PSCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输出

Microsoft.Unix.Computer[]

此 cmdlet 返回一组升级结果，每个结果表示计算机的升级状态。每个结果必须包含以下信息：

主机名
操作系统
旧代理版本
新代理版本
升级状态
描述

说明包括升级失败的原因的详细信息。

备注

此 cmdlet 采用枚举方式的主机名集合。它会收集所有主机名，并在管道末尾并行处理整个集合。

通过