共用方式為

Get-CimSession

  • 參考
模組:
CimCmdlets

從目前的工作階段取得 CIM 工作階段物件。

語法

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

Description

Get-CimSession Cmdlet 會取得在目前 PowerShell 工作階段中建立的 CIM 會話物件。

如果未使用任何參數，Cmdlet 會取得在目前 PowerShell 工作階段中建立的所有 CIM 會話。 您可以使用 Get-CimSession 的參數來取得特定計算機的會話，也可以依其名稱、標識碼或實例標識碼來識別會話。

如需 PowerShell 工作階段的詳細資訊，請參閱 about_CimSession。

範例

範例 1：從目前的 PowerShell 工作階段取得 CIM 工作階段

根據預設，Get-CimSession 只會取得目前 PowerShell 工作階段中存在之 CIM 工作階段的相關信息。 Get-CimSession 不會取得在其他 PowerShell 工作階段中建立或在其他電腦上建立的 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

此命令會取得名稱開頭為字元伺服器的所有 CIM 工作階段。

範例 5：取得特定的 CIM 會話

Get-CimSession -ID 2

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

此命令會取得標識碼為 2 的 CIM 工作階段。

參數

-ComputerName

指定要連接 CIM 工作階段的電腦名稱。 允許通配符。

類型:String[]
別名:CN, ServerName
Position:0
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:True

-Id

指定要取得之 CIM 會話的標識碼（ID）。 若為一或多個識別碼，請使用逗號來分隔標識符，或使用範圍運算符 （...） 來指定標識符的範圍。

標識碼是整數，可唯一識別目前PowerShell會話中的 CIM 會話。 比 InstanceId 更容易記住和輸入，但只在目前的 PowerShell 工作階段中是唯一的。

如需範圍運算子的詳細資訊，請參閱 about_Operators。

類型:UInt32[]
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-InstanceId

指定要取得之 CIM 會話的實例識別碼。

InstanceId 是可唯一識別 CIM 作業階段的 GUID。 InstanceId 是唯一的，即使您在 PowerShell 中執行多個作業階段也是如此。

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

類型:Guid[]
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-Name

取得包含指定易記名稱的一或多個 CIM 工作階段。 允許通配符。

類型:String[]
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:True

輸入

None

輸出

CimSession