共用方式為

Remove-SCXAgent

  • 參考
模組:
OperationsManager

從管理群組中移除目標受控 UNIX 和 Linux 計算機。

語法

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

第一個命令會使用 Get-SCXAgent Cmdlet，取得符合指定名稱的受控 Linux 或 UNIX 計算機的代理程式。 命令會將結果儲存在$Agents陣列變數中。

最後一個命令會移除 $Agents 中的代理程式。

範例 2：使用定義的執行身分帳戶卸載管理代理程式

PS C:\>Get-SCXAgent -Name "scxserver1.contoso.com","scxserver2*","*.development.contoso.com" | Remove-SCXAgent

此命令會使用 Get-SCXAgent 取得符合指定名稱之受控 Linux 或 UNIX 計算機的代理程式。 命令會將代理程序傳遞至目前的 Cmdlet。 命令會移除管理代理程式。

參數

-Agent

指定一或多個受控 UNIX 和 Linux 計算機物件。 如需如何取得 Managed UNIX 或 Linux 計算機物件的相關信息，請輸入 Get-Help Get-SCXAgent。

類型:IPersistedUnixComputer[]
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-ComputerName

指定計算機名稱的陣列。 Cmdlet 會為這些電腦建立管理群組的暫時連線。 您可以使用 NetBIOS 名稱、IP 位址或完整功能變數名稱 （FQDN）。 若要指定本機計算機，請輸入計算機名稱、localhost 或點 （.）。

System Center 資料存取服務必須在電腦上使用中。 如果您未指定計算機，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

指定 connection 物件的 陣列。 若要取得 Connection 物件，請使用 get-SCOMManagementGroupConnection Cmdlet Get-SCOMManagementGroupConnection。

如果未指定此參數，Cmdlet 會使用與管理群組的作用中持續性連線。 使用 SCSession 參數來指定不同的持續性連線。 您可以使用 ComputerName 和 Credential 參數，建立與管理群組的暫時連線。 如需詳細資訊，請輸入 Get-Help about_OpsMgr_Connections。

類型:Connection[]
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。

類型:SwitchParameter
別名:wi
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

輸出

此 Cmdlet 不會產生任何輸出。 Remove-SCXAgent Cmdlet 沒有失敗案例。