次の方法で共有

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 にそれらのコンピューターを渡して Computer062 を検索し、 Where-Object を 使用して ContosoAgent という名前のエージェントを検索します。 コマンドは、これらのインスタンスを$WindowsComputers変数に格納します。

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

パラメーター

-ComputerName

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

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

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

-Confirm

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

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

-Credential

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

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

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

-InputObjects

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

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

-SCSession

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

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

Type:Connection[]
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