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
コンピューターの名前の配列を指定します。 指定したコンピューターに接続するセッションを削除します。 完全修飾ドメイン名 (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) です。 InstanceId は、PowerShell で複数のセッションが実行されている場合でも一意です。
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
オブジェクトをこのコマンドレットにパイプすることはできません。
出力
このコマンドレットは、CIM セッション情報を含む オブジェクトを返します。
メモ
PowerShell には、 の次のエイリアスが Remove-CimSession
含まれています。
- Windows の場合:
rcms
このコマンドレットは、Windows プラットフォームでのみ使用できます。