Uninstall-SCOMAgent

  • リファレンス
モジュール:
OperationsManager

エージェントで管理されているコンピューターからエージェントをアンインストールします。

構文

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

説明

Uninstall-SCOMAgent コマンドレットは、エージェントで管理されるコンピューターからエージェントをアンインストールします。 エージェントをアンインストールする前に、Active Directory Domain Services (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 コマンドレットに渡します。 2 番目のコマンドは、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変数にオブジェクトを格納します。

2 番目のコマンドは、$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 変数に格納します。

2 番目のコマンドは、Operations Manager がエージェントのアンインストールに使用する資格情報を入力するようにユーザーに求めます。 次に、このコマンドは、$Agentに格納されているエージェントをアンインストールします。

パラメーター

-ActionAccount

PSCredential オブジェクトを指定します。 このパラメーターは、Operations Manager が展開タスクの実行に使用する資格情報を指定します。 このパラメーターを指定しない場合、または null 値を指定した場合、Operations Manager はエージェントの管理サーバーの既定のアクション アカウントを使用します。

PSCredential オブジェクトを取得するには、Get-Credential コマンドレットを使用します。 詳細を表示するには「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 コマンドレットを使用します。

Type:AgentManagedComputer[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

パイプラインでコマンドが使用できるオブジェクトをコマンドレットで作成または変更することを示します。 既定では、このコマンドレットによる出力はありません。

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

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

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