Get-CimSession
現在のセッションから CIM セッション オブジェクトを取得します。
構文
Get-CimSession
[[-ComputerName] <String[]>]
[<CommonParameters>] Get-CimSession
[-Id] <UInt32[]>
[<CommonParameters>] Get-CimSession
-InstanceId <Guid[]>
[<CommonParameters>] Get-CimSession
-Name <String[]>
[<CommonParameters>] 説明
Get-CimSession コマンドレットは、現在の PowerShell セッションで作成された CIM セッション オブジェクトを取得します。
パラメーターなしで使用すると、コマンドレットは現在の PowerShell セッションで作成されたすべての CIM セッションを取得します。
のパラメーター Get-CimSession を使用して、特定のコンピューター用のセッションを取得することも、セッションの名前、ID、またはインスタンス ID でセッションを識別することもできます。
PowerShell セッションの詳細については、「 about_CimSession」を参照してください。
例
例 1: 現在の PowerShell セッションから CIM セッションを取得する
既定では、 Get-CimSession 現在の PowerShell セッションに存在する CIM セッションに関する情報のみを取得します。
Get-CimSession は、他の PowerShell セッションで作成された CIM セッションや、他のコンピューターで作成された CIM セッションを取得しません。
New-CimSession -ComputerName Server01,Server02
Get-CimSession
Id : 1
Name : CimSession1
InstanceId : d1413bc3-162a-4cb8-9aec-4d2c61253d59
ComputerName : Server01
Protocol : WSMAN
Id : 2
Name : CimSession2
InstanceId : c0095981-52c5-4e7f-a5bb-c4c680541710
ComputerName : Server02
Protocol : WSMANこのコマンドは、まず New-CimSession を使用して CIM セッションを作成し、 を使用して CIM セッションを Get-CimSession取得します。
例 2: 特定のコンピューターに CIM セッションを取得する
Get-CimSession -ComputerName Server02
Id : 2
Name : CimSession2
InstanceId : c0095981-52c5-4e7f-a5bb-c4c680541710
ComputerName : Server02
Protocol : WSMANこのコマンドは、Server02 という名前のコンピューターに接続されている CIM セッションを取得します。
例 3: CIM セッションのリストを取得し、リストをフォーマットする
Get-CimSession | Format-Table -Property ComputerName,InstanceId
ComputerName InstanceId
------------ ----------
Server01 d1413bc3-162a-4cb8-9aec-4d2c61253d59
Server02 c0095981-52c5-4e7f-a5bb-c4c680541710このコマンドは、現在の PowerShell セッション内のすべての CIM セッションを取得し、 ComputerName プロパティと InstanceID プロパティのみを含むテーブル内のリストの書式を設定します。
例 4: 特定の名前を持つすべての CIM セッションを取得する
Get-CimSession -ComputerName Serv*
Id : 1
Name : CimSession1
InstanceId : d1413bc-162a-4cb8-9aec-4d2c61253d59
ComputerName : Server01
Protocol : WSMAN
Id : 2
Name : CimSession2
InstanceId : c0095981-52c5-4e7f-a5bb-c4c680541710
ComputerName : Server02
Protocol : WSMANこのコマンドは、文字 serv で始まる名前を持つすべての CIM セッションを取得します。
例 5: 特定の CIM セッションを取得する
Get-CimSession -ID 2
Id : 2
Name : CimSession2
InstanceId : c0095981-52c5-4e7f-a5bb-c4c680541710
ComputerName : Server02
Protocol : WSMANこのコマンドは、ID が 2 の CIM セッションを取得します。
パラメーター
-ComputerName
CIM セッションを接続するコンピューターの名前を指定します。 ワイルドカード文字を使用できます。
| Type: | String[] |
| Aliases: | CN, ServerName |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | True |
-Id
取得する CIM セッションの識別子 (ID) を指定します。 1 つ以上の ID の場合は、コンマを使用して ID を区切るか、範囲演算子 (..) を使用して ID の範囲を指定します。
ID は、現在の PowerShell セッションの CIM セッションを一意に識別する整数です。 InstanceId よりも覚えて入力する方が簡単ですが、現在の PowerShell セッション内でのみ一意です。
範囲演算子の詳細については、「 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
指定したフレンドリ名を含む 1 つ以上の CIM セッションを取得します。 ワイルドカード文字を使用できます。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | True |
入力
None