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の次のエイリアスが含まれています。

  • Windows:
    • rcms

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