次の方法で共有

Remove-SCAdvisorAgent

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

Advisor コネクタに報告するエージェントのグループから 1 つ以上のエージェントを削除します。

構文

Remove-SCAdvisorAgent
      [-InputObjects <PartialMonitoringObject[]>]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

Remove-SCAdvisorAgent コマンドレットは、System Center Advisor コネクタに報告するエージェントのグループから 1 つ以上のエージェントを削除します。

例

例 1: コンピューターのグループから名前でエージェントを削除する

PS C:\> $WindowsComputers = Get-SCClass -Name "Microsoft.Windows.computer" | Get-SCOMClassInstance | Where {$_.Name.Contains("ContosoAgent")}
PS C:\> Remove-SCAdvisorAgent -InputObjects $WindowsComputers

最初のコマンドでは、Get-SCClass コマンドレットを使用して Windows ベースのすべてのコンピューターを取得し、パイプライン オペレーターを使用してそれらのコンピューターを Get-SCOMClassInstance コマンドレットに渡し、次に Where-Object コマンドレットを使用して ContosoAgent という名前のコンピューターを検索します。 このコマンドは、これらのインスタンスを $WindowsComputers 変数に格納します。 詳細については、「Get-Help Where-Object」と入力します。

2 番目のコマンドは、Advisor コネクタに報告するエージェントのグループから、$WindowsComputersに格納されているすべてのエージェントを削除します。

例 2: コンピューターから名前でエージェントを削除する

PS C:\> $WindowsComputers = Get-SCClass -Name "Microsoft.Windows.computer" | Get-SCOMClassInstance -ComputerName "Computer062" | Where {$_.Name.Contains("ContosoAgent")}
PS C:\> Remove-SCAdvisorAgent -InputObjects $WindowsComputers -ComputerName "Computer062"

最初のコマンドでは、Get-SCClass を使用してすべての Windows ベースのコンピューターを取得し、パイプライン 演算子を使用して Get-SCOMClassInstance を に渡し、次に Where-Object を使用して ContosoAgent という名前のエージェントを検索します。 このコマンドは、これらのインスタンスを $WindowsComputers 変数に格納します。

2 番目のコマンドは、Advisor コネクタに報告するエージェントのグループから、$WindowsComputersに格納されているすべての Windows ベースのコンピューターを削除します。

パラメーター

-ComputerName

コンピューターの名前の配列を指定します。 コマンドレットは、これらのコンピューターの管理グループとの一時的な接続を確立します。 NetBIOS 名、IP アドレス、または完全修飾ドメイン名 (FQDN) を使用できます。 ローカル コンピューターを指定するには、コンピューター名、localhost、またはドット (.) を入力します。

System Center Data Access サービスは、コンピューター上でアクティブである必要があります。 コンピューターを指定しない場合、コマンドレットは現在の管理グループ接続にコンピューターを使用します。

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

-Confirm

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

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

-Credential

管理グループ接続を実行するユーザー アカウントを指定します。 Get-Credential コマンドレットから返されるオブジェクトなど、PSCredential オブジェクトをこのパラメーターに指定します。 資格情報オブジェクトの詳細については、「Get-Help Get-Credential」と入力します。

ComputerName パラメーターでコンピューターを指定する場合は、そのコンピューターにアクセスできるアカウントを使用します。 既定値は現在のユーザーです。

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

-InputObjects

Advisor コネクタからオプトアウトするコンピューター名の配列を指定します。

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

-SCSession

Connection オブジェクトの配列 指定します。 Connection オブジェクト 取得するには、Get-SCOMManagementGroupConnection コマンドレットを使用します。

このパラメーターを指定しない場合、コマンドレットは管理グループへのアクティブな永続的な接続を使用します。 SCSession パラメーターを使用して、別の永続的な接続を指定します。 ComputerName パラメーターと Credential パラメーターを使用して、管理グループへの一時的な接続を作成できます。 詳細については、「Get-Help about_OpsMgr_Connections」と入力します。

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

-WhatIf

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

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