次の方法で共有


Get-CimSession

現在のセッションから CIM セッション オブジェクトを取得します。

構文

ComputerNameSet (既定)

Get-CimSession
    [[-ComputerName] <String[]>]
    [<CommonParameters>]

SessionIdSet

Get-CimSession
    [-Id] <UInt32[]>
    [<CommonParameters>]

InstanceIdSet

Get-CimSession
    -InstanceId <Guid[]>
    [<CommonParameters>]

NameSet

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 セッションを作成し、次に Get-CimSession を使用して CIM セッションを取得します。

例 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 セッションを接続するコンピューターの名前を指定します。 ワイルドカード文字を使用できます。

パラメーターのプロパティ

型:

String[]

規定値:None
ワイルドカードのサポート:True
DontShow:False
Aliases:CN, サーバー名

パラメーター セット

ComputerNameSet
配置:0
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Id

取得する CIM セッションの ID (ID) を指定します。 1 つ以上の ID の場合は、カンマを使用して ID を区切るか、範囲演算子 (..) を使用して ID の範囲を指定します。

ID は、現在の PowerShell セッション内の CIM セッションを一意に識別する整数です。 InstanceId よりも覚えやすく、入力するのは簡単ですが、現在の PowerShell セッション内でのみ一意です。

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

パラメーターのプロパティ

型:

UInt32[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

SessionIdSet
配置:0
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-InstanceId

取得する CIM セッションのインスタンス ID を指定します。

InstanceId は、CIM セッションを一意に識別する GUID です。 InstanceId は、PowerShell で複数のセッションを実行している場合でも一意です。

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

パラメーターのプロパティ

型:

Guid[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

InstanceIdSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Name

1つ以上のCIMセッションを取得します。それらには指定されたフレンドリ名が含まれています。 ワイルドカード文字を使用できます。

パラメーターのプロパティ

型:

String[]

規定値:None
ワイルドカードのサポート:True
DontShow:False

パラメーター セット

NameSet
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

入力

None

出力

CimSession