Uninstall-SCXAgent
在指定的受控 UNIX 和 Linux 電腦上卸載管理代理程式。
Syntax
Uninstall-SCXAgent
-Agent <IPersistedUnixComputer[]>
[-SshCredential <CredentialSet>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
Uninstall-SCXAgent Cmdlet 會卸載指定 UNIX 和 Linux 電腦上的管理代理程式。
必要的 Agent 參數會指定要卸載的目標 Managed 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 電腦物件。
如需如何取得 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
指定用來執行代理程式維護動作的特殊許可權 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 會傳回結果，代表電腦的卸載狀態。 結果包含下列資訊：
- 主機名稱
- 卸載狀態
- 描述
描述包含卸載失敗原因的詳細資料。