Get-CimSession

模組:
CimCmdlets Module

從目前會話取得 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>]

Description

此 Cmdlet 只能在 Windows 平臺上使用。

預設情況下，指令長會接收目前 PowerShell 會話中建立的所有 CIM 會話。 你可以用參數 Get-CimSession 取得特定電腦的會話，或者用會話名稱或其他識別碼來識別。 Get-CimSession 不會取得在其他 PowerShell 會話中建立或在其他電腦建立的 CIM 會話。

欲了解更多關於CIM會議的資訊，請參見 about_CimSession。

範例

範例 1：從目前的 PowerShell 會話取得 CIM 會話

此範例使用 New-CimSession 建立 CIM 會話，然後使用 Get-CimSession。

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

範例五：取得特定的 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[]

預設值:None
支援萬用字元:True
不要顯示:False
別名:中國, 伺服器名稱

參數集

ComputerNameSet
Position:0
必要:False
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Id

指定要取得的 CIM 會話識別碼。 對於多個 ID，請使用逗號分隔 ID，或使用範圍運算子（..）來指定 ID 範圍。 ID 是一個整數，唯一識別目前 PowerShell 會話中的 CIM 會話。

欲了解更多關於距離運算子的資訊，請參見 about_Operators。

參數屬性

類型:

UInt32[]

預設值:None
支援萬用字元:False
不要顯示:False

參數集

SessionIdSet
Position:0
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-InstanceId

指定要取得的 CIM 會話實例 ID。

InstanceId 是一個全球唯一識別碼（GUID），可唯一識別 CIM 會話。 InstanceID 是唯一的，即使你在 PowerShell 裡有多個工作階段。

InstanceId 會儲存在代表 CIM 會話的物件的 InstanceId 屬性中。

參數屬性

類型:

Guid[]

預設值:None
支援萬用字元:False
不要顯示:False

參數集

InstanceIdSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Name

取得一個或多個包含指定友善名稱的 CIM 會話。 允許使用通配符字元。

參數屬性

類型:

String[]

預設值:None
支援萬用字元:True
不要顯示:False

參數集

NameSet
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

CommonParameters

此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。

輸入

None

您不能將物件透過管道傳送到此 Cmdlet。

輸出

CimSession

此 Cmdlet 會傳回 CIM 會話物件。

備註

PowerShell 包含下列 Get-CimSession的別名：

  • 窗戶：
    • gcms

此 Cmdlet 僅適用於 Windows 平臺。