共用方式為

Uninstall-SCOMAgent

  • 參考
模組:
OperationsManager

從代理程式管理的電腦卸載代理程式。

Syntax

Uninstall-SCOMAgent
         [-ActionAccount <PSCredential>]
         -Agent <AgentManagedComputer[]>
         [-PassThru]
         [-WhatIf]
         [-Confirm]
         [<CommonParameters>]

Description

Uninstall-SCOMAgent Cmdlet 會從代理程式管理的電腦卸載代理程式。 卸載代理程式之前，您必須先從管理群組中移除Active Directory 網域服務 (AD DS) 代理程式指派。 您可以使用 Remove-SCOMADAgentAssignment Cmdet，從管理群組移除 AD DS 代理程式指派。

範例

範例 1：卸載代理程式

PS C:\>Get-SCOMAgent -DNSHostName "server01.contoso.com" | Uninstall-SCOMAgent

第一個命令會取得名為 server01.contoso.com 的 Operations Manager 代理程式物件，並使用管線運算子將它傳遞給 Uninstall-SCOMAgent Cmdlet。 第二個命令會卸載名為 server01.contoso.com 的代理程式。

範例 2：使用物件變數卸載代理程式

PS C:\>$Agent = Get-SCOMAgent -DNSHostName "server01.contoso.com"
PS C:\> Uninstall-SCOMAgent -Agent $Agent

此範例會卸載代理程式管理電腦上的 Operations Manager 代理程式。

第一個命令會取得名為 server01.contoso.com 的代理程式管理電腦物件，並將物件儲存在$Agent變數中。

第二個命令會卸載儲存在 $Agent 中的代理程式。

範例 3：使用動作帳戶卸載代理程式

PS C:\>$Agent = Get-SCOMAgent -DNSHostName "server01.contoso.com"
PS C:\> Uninstall-SCOMAgent -Agent $Agent -ActionAccount (Get-Credential)

此範例在使用者輸入 Operations Manager 卸載代理程式需要卸載代理程式所需的認證之後，將 Operations Manager 代理程式卸載。

第一個命令會取得名為 server01.contoso.com 的代理程式物件，並將物件儲存在$Agent變數中。

第二個命令會提示使用者輸入 Operations Manager 用來卸載代理程式的認證。 命令接著會卸載儲存在 $Agent 中的代理程式。

參數

-ActionAccount

指定 PSCredential 物件。 此參數會指定 Operations Manager 用來執行部署工作的認證。 如果您未指定此參數或指定 Null 值，Operations Manager 會使用代理程式管理伺服器的預設動作帳戶。

若要取得 PSCredential 物件，請使用 Get-Credential Cmdlet。 如需詳細資訊，請鍵入 Get-Help Get-Credential。

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Agent

指定 AgentManagedComputer 物件的陣列。 此參數指定要卸載的 Operations Manager 代理程式。 若要取得 AgentManagedComputer 物件，請使用 Get-SCOMADAgent Cmdlet。

Type:AgentManagedComputer[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
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

-PassThru

表示 Cmdlet 會建立或修改命令可以在管線中使用的物件。 根據預設，此 Cmdlet 不會產生任何輸出。

Type:SwitchParameter
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

輸入

Microsoft.EnterpriseManagement.Administration.AgentManagedComputer

輸出

Microsoft.EnterpriseManagement.Administration.AgentTaskResult