次の方法で共有

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 エージェントをアンインストールします。

最初のコマンドは、server01.contoso.com という名前のエージェント オブジェクトを取得し、そのオブジェクトを $Agent 変数に格納します。

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

パラメーター

-ActionAccount

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

PSCredential オブジェクトを取得するには、Get-Credential コマンドレットを使用します。 詳細については、「Get-Help Get-Credential」と入力します。

型:PSCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Agent

AgentManagedComputer オブジェクト 配列を指定します。 このパラメーターは、アンインストールする Operations Manager エージェントを指定します。 AgentManagedComputer オブジェクトを取得するには、Get-SCOMADAgent コマンドレットを使用します。

型:AgentManagedComputer[]
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Confirm

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

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PassThru

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

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

Microsoft.EnterpriseManagement.Administration.AgentManagedComputer

出力

Microsoft.EnterpriseManagement.Administration.AgentTaskResult