Remove-CimSession

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 セッションを作成または取得するコマンド (コマンドレットGet-CimSessionなど) をNew-CimSession入力します。 詳細については、「about_CimSessions」を参照してください

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

-ComputerName

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

Type:String[]
Aliases:CN, ServerName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Confirm

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

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

-Id

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

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

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

-InstanceId

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

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

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

-Name

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

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

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

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

入力

None

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

出力

Object

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

メモ

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

  • Windows:
    • rcms

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