Remove-SCXAgent
從管理群組中移除目標受控 UNIX 和 Linux 電腦。
Syntax
Remove-SCXAgent
-Agent <IPersistedUnixComputer[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Remove-SCXAgent Cmdlet 會從管理群組中移除目標受控 UNIX 和 Linux 電腦。 受控 UNIX 和 Linux 電腦會以 UNIX 和 Linux 電腦物件的陣列的形式傳遞至 Remove-SCXAgent Cmdlet。
如需擷取受控 UNIX 和 Linux 電腦的相關資訊,請參閱 Get-SCXAgent Cmdlet。
此 Cmdlet 不會傳回任何輸出。
範例
範例 1:移除管理代理程式
PS C:\>$Agents = Get-SCXAgent -Name "scxserver1.contoso.com","scxserver2*","*.development.contoso.com"
PS C:\> Remove-SCXAgent -Agent $Agents
第一個命令會取得受控 Linux 或 UNIX 電腦的代理程式,這些電腦會使用 Get-SCXAgent Cmdlet 來比對指定的名稱。 此命令會將結果儲存在$Agents陣列變數中。
最後一個命令會移除 $Agents 中的代理程式。
範例 2:使用定義的執行身分帳戶卸載管理代理程式
PS C:\>Get-SCXAgent -Name "scxserver1.contoso.com","scxserver2*","*.development.contoso.com" | Remove-SCXAgent
此命令會取得受管理 Linux 或 UNIX 電腦的代理程式,這些電腦會使用 Get-SCXAgent來比對指定的名稱。 命令會將代理程式傳遞至目前的 Cmdlet。 命令會移除管理代理程式。
參數
-Agent
指定一或多個 Managed 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 |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 Cmdlet 並不會執行。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
輸出
此 Cmdlet 不會產生任何輸出。 Remove-SCXAgent Cmdlet 沒有失敗案例。