次の方法で共有

Get-CimSession

モジュール:
CimCmdlets Module

Gets the CIM session objects from the current session.

構文

ComputerNameSet (既定) 

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

SessionIdSet 

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

InstanceIdSet 

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

NameSet 

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

説明

This cmdlet is only available on the Windows platform.

By default, the cmdlet gets all of the CIM sessions created in the current PowerShell session. You can use the parameters of Get-CimSession to get the sessions that are for particular computers, or you can identify sessions by their names or other identifiers. Get-CimSession does not get CIM sessions that were created in other PowerShell sessions or that were created on other computers.

For more information about CIM sessions, see about_CimSession.

例

Example 1: Get CIM sessions from the current PowerShell session

This example creates CIM sessions using New-CimSession, and then gets the CIM sessions using 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

Example 2: Get the CIM sessions to a specific computer

This example gets the CIM sessions that are connected to the computer named Server02.

Get-CimSession -ComputerName Server02

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

Example 3: Get a list of CIM sessions and then format the list

This example gets all CIM sessions in the current PowerShell session and displays a table containing only the ComputerName and InstanceId properties.

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

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

Example 4: Get all the CIM sessions that have specific names

This example gets all CIM sessions that have names that begin with Serv.

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

Example 5: Get a specific CIM session

This example gets the CIM session that has an Id of 2.

Get-CimSession -Id 2

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

パラメーター

-ComputerName

Specifies the name of the computer to get CIM sessions connected to. Wildcard characters are permitted.

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

型:

String[]

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

パラメーター セット

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

-Id

Specifies the identifier of the CIM session to get. For multiple IDs, use commas to separate the IDs or use the range operator (..) to specify a range of IDs. An Id is an integer that uniquely identifies the CIM session within the current PowerShell session.

For more information about the range operator, see about_Operators.

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

型:

UInt32[]

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

パラメーター セット

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

-InstanceId

Specifies the instance IDs of the CIM session to get.

InstanceId is a globally-unique identifier (GUID) that uniquely identifies a CIM session. The InstanceId is unique, even when you have multiple sessions running in PowerShell.

The InstanceId is stored in the InstanceId property of the object that represents a CIM session.

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

型:

Guid[]

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

パラメーター セット

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

-Name

Gets one or more CIM sessions which contain the specified friendly names. Wildcard characters are permitted.

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

型:

String[]

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

パラメーター セット

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

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

入力

None

You can't pipe objects to this cmdlet.

出力

CimSession

This cmdlet returns a CIM session object.

メモ

PowerShell includes the following aliases for Get-CimSession:

  • Windows:
    • gcms

This cmdlet is only available on Windows platforms.