次の方法で共有

Get-CimSession

  • リファレンス
モジュール:
CimCmdlets

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

構文

Get-CimSession
   [[-ComputerName] <String[]>]
   [<CommonParameters>]
Get-CimSession
   [-Id] <UInt32[]>
   [<CommonParameters>]
Get-CimSession
   -InstanceId <Guid[]>
   [<CommonParameters>]
Get-CimSession
   -Name <String[]>
   [<CommonParameters>]

説明

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

既定では、コマンドレットは現在の PowerShell セッションで作成されたすべての CIM セッションを取得します。 Get-CimSessionのパラメーターを使用して、特定のコンピューター用のセッションを取得したり、セッションの名前やその他の識別子でセッションを識別したりできます。 Get-CimSession では、他の PowerShell セッションで作成された CIM セッションや、他のコンピューターで作成された CIM セッションは取得されません。

CIM セッションの詳細については、 about_CimSessionを参照してください。

例

例 1: 現在の PowerShell セッションから CIM セッションを取得する

この例では、 New-CimSession を使用して CIM セッションを作成し、 Get-CimSessionを使用して 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

例 2: 特定のコンピューターへの CIM セッションを取得する

この例では、 Server02 という名前のコンピューターに接続されている CIM セッションを取得します。

Get-CimSession -ComputerName Server02

Id           : 2
Name         : CimSession2
InstanceId   : c0095981-52c5-4e7f-a5bb-c4c680541710
ComputerName : Server02
Protocol     : WSMAN

例 3: CIM セッションのリストを取得し、リストをフォーマットする

この例では、現在の PowerShell セッションのすべての CIM セッションを取得し、 ComputerName および InstanceID プロパティのみを含むテーブルを表示します。

Get-CimSession | Format-Table -Property ComputerName,InstanceId

ComputerName InstanceId
------------ ----------
Server01     d1413bc3-162a-4cb8-9aec-4d2c61253d59
Server02     c0095981-52c5-4e7f-a5bb-c4c680541710

例 4: 特定の名前を持つすべての CIM セッションを取得する

この例では、名前が serv で始まるすべての 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

例 5: 特定の CIM セッションを取得する

この例では、 Id 2 の CIM セッションを取得します。

Get-CimSession -ID 2

Id           : 2
Name         : CimSession2
InstanceId   : c0095981-52c5-4e7f-a5bb-c4c680541710
ComputerName : Server02
Protocol     : WSMAN

パラメーター

-ComputerName

CIM セッションを接続するコンピューターの名前を指定します。 ワイルドカード文字を使用できます。

型:String[]
Aliases:CN, ServerName
配置:0
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:True

-Id

取得する CIM セッションの識別子を指定します。 複数の ID の場合は、コンマを使用して 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

指定したフレンドリ名を含む 1 つ以上の CIM セッションを取得します。 ワイルドカード文字を使用できます。

型:String[]
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:True

入力

None

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

出力

CimSession

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

メモ

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

  • Windows:
    • gcms

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