Remove-CimSession

リファレンス

モジュール:: CimCmdlets

1 つ以上の CIM セッションを削除します。

構文

Remove-CimSession
      [-CimSession] <CimSession[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CimSession
      [-ComputerName] <String[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CimSession
      [-Id] <UInt32[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CimSession
      -InstanceId <Guid[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CimSession
      -Name <String[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

このコマンドレットは、Windows プラットフォームでのみ使用できます。

Remove-CimSession コマンドレットは、ローカル PowerShell セッションから 1 つ以上の CIM セッションオブジェクトを削除します。

例

例 1: すべての CIM セッションを削除する

次の使用例は、Get-CimSession コマンドレットを使用してローカルコンピューターで使用可能なすべての CIM セッションを取得し、Remove-CimSessionを使用して削除します。

Get-CimSession | Remove-CimSession

例 2: 特定の CIM セッションを削除する

この例では、ID 値が 5 の CIM セッションを削除します。

Remove-CimSession -Id 5

例 3: WhatIf パラメーターを使用して削除する CIM セッションのリストを表示する

この例では、WhatIf 共通パラメーターを使用して、削除を実行しないように指定しますが、実行された場合に何が起こるかを出力するだけです。

Remove-CimSession -Name a* -WhatIf

パラメーター

-CimSession

閉じる CIM セッションのセッションオブジェクトを指定します。

CIM セッションを含む変数、または CIM セッションを作成または取得するコマンド (New-CimSession、Get-CimSession コマンドレットなど) を入力します。詳細については、about_CimSessionsを参照してください。

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

-ComputerName

コンピューターの名前の配列を指定します。指定したコンピューターに接続するセッションを削除します。完全修飾ドメイン名 (FQDN) または NetBIOS 名を指定できます。

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

-Confirm

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

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

-Id

削除する CIM セッションの ID を指定します。 1 つ以上の ID をコンマで区切って指定するか、範囲演算子 (..) を使用して ID の範囲を指定します。 ID は、現在の PowerShell セッションの CIM セッションを一意に識別する整数です。

範囲演算子の詳細については、about_Operatorsを参照してください。

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

-InstanceId

削除する CIM セッションのインスタンス ID を指定します。 InstanceId は、CIM セッションを一意に識別するグローバル一意識別子 (GUID) です。 InstanceId は、PowerShell で複数のセッションが実行されている場合でも一意です。

InstanceId は、CIM セッションを表すオブジェクトの InstanceId プロパティに格納されます。

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

-Name

削除する CIM セッションのフレンドリ名を指定します。このパラメーターにはワイルドカード文字を使用できます。

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

-WhatIf

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

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

入力

None

このコマンドレットにオブジェクトをパイプすることはできません。

出力

Object

このコマンドレットは、CIM セッション情報を含むオブジェクトを返します。

メモ

PowerShell には、Remove-CimSessionの次のエイリアスが含まれています。

ウィンドウズ：
- rcms

このコマンドレットは、Windows プラットフォームでのみ使用できます。