Update-SCXAgent
將指定 UNIX 和 Linux 電腦上的管理代理程式升級至可用的最新版本。
Syntax
Update-SCXAgent
-Agent <IPersistedUnixComputer[]>
[-WsManCredential <PSCredential>]
[-SshCredential <CredentialSet>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
Update-SCXAgent Cmdlet 會將指定電腦上的代理程式更新為可用的最新版本。 如果已安裝目的電腦的最新可用管理代理程式版本，則不會採取任何動作。
必要的 Agent 參數會指定要卸載的目標 Managed UNIX 和 Linux 電腦，而且需要 UNIX 和 Linux 電腦物件。 如需擷取受控 UNIX 和 Linux 電腦的相關資訊，請參閱 Get-SCXAgent Cmdlet。 此 Cmdlet 接受 SshCredential 和 WsManCredential 輸入參數。 提供的 SshCredential 參數用於特殊許可權代理程式更新動作，而提供的 WsManCredential 則用於低許可權代理程式通訊。 如果未提供 SshCredential 參數，Cmdlet 會嘗試使用與目的電腦相關聯的已定義代理程式維護執行身分帳戶。
此 Cmdlet 的輸出是 Managed 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 電腦物件。
如需如何取得 Managed 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 資料存取服務必須在電腦上使用中。 如果您未指定電腦，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
指定用來執行代理程式更新動作的特殊許可權 SshCredential 參數。 如果未指定此參數，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 |
-WsManCredential
指定用來透過 WSMan 進行低許可權代理程式通訊的認證。 此 Cmdlet 會使用此認證來驗證代理程式可用性。
輸入使用者名稱，例如 User01 或輸入 PSCredential 物件，例如 Get-Credential Cmdlet 所傳回的使用者名稱。 當您輸入使用者名稱時，會提示您輸入密碼。
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
輸出
Microsoft.Unix.Computer[]
此 Cmdlet 會傳回升級結果的集合，每一個都代表電腦的升級狀態。 每個結果都必須包含下列資訊：
- Hostname (主機名稱)
- 作業系統
- 舊代理程式版本
- 新的代理程式版本
- 升級狀態
- 描述
描述包含升級失敗原因的詳細資料。
備註
- 此 Cmdlet 會以列舉方式採用主機名稱的集合。 它會收集所有主機名稱，並在管線結尾平行處理整個集合。