Remove-SCXAgent

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

管理グループから、対象の管理対象 UNIX および Linux コンピューターを削除します。

構文

Remove-SCXAgent
      -Agent <IPersistedUnixComputer[]>
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

Remove-SCXAgent コマンドレットは、管理グループから対象の管理対象 UNIX および Linux コンピューターを削除します。 マネージド UNIX および Linux コンピューターは、UNIX および Linux コンピューター オブジェクトの配列として Remove-SCXAgent コマンドレットに渡されます。

マネージド UNIX および Linux コンピューターの取得については、Get-SCXAgent コマンドレットを参照してください。

このコマンドレットによる戻り値はありません。

例

例 1: 管理エージェントを削除する

PS C:\>$Agents = Get-SCXAgent -Name "scxserver1.contoso.com","scxserver2*","*.development.contoso.com"
PS C:\> Remove-SCXAgent -Agent $Agents

最初のコマンドは、Get-SCXAgent コマンドレットを使用して、指定した名前と一致するマネージド Linux または UNIX コンピューターのエージェントを取得します。 このコマンドは、結果を$Agents配列変数に格納します。

最後のコマンドは、$Agents内のエージェントを削除します。

例 2: 定義された実行アカウントを使用して管理エージェントをアンインストールする

PS C:\>Get-SCXAgent -Name "scxserver1.contoso.com","scxserver2*","*.development.contoso.com" | Remove-SCXAgent

このコマンドは、 Get-SCXAgent を使用して、指定された名前と一致するマネージド Linux または UNIX コンピューターのエージェントを取得します。 このコマンドは、エージェントを現在のコマンドレットに渡します。 このコマンドは、管理エージェントを削除します。

パラメーター

-Agent

1 つ以上の管理対象 UNIX および Linux コンピューター オブジェクトを指定します。 マネージド UNIX または Linux コンピューター オブジェクトを取得する方法については、「.」と入力します Get-Help Get-SCXAgent。

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

-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

-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

出力

このコマンドレットは出力を生成しません。 Remove-SCXAgent コマンドレットのエラー ケースはありません。