Get-​Cim​Session

Gets the CIM session objects from the current session.

Syntax

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

Description

The Get-CimSession cmdlet gets the CIM session objects created in the current wps_1 session.

If used without any parameters, the cmdlet gets all of the CIM sessions created in the current wps_2 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, IDs, or instance IDs.

For more information about wps_2 sessions, see about_CimSessions

Examples

-------------------------- EXAMPLExample 1: Get CIM sessions from the current wps_2 session. --------------------------xample: Get CIM sessions from the current wps_2 session.

By default, Get-CimSession only gets information about the CIM sessions that exist in the current wps_2 session. Get-CimSession does not get CIM sessions that were created in other wps_2 sessions or that were created on other computers.
PS C:\> New-CimSession -ComputerName Server01,Server02



PS C:\> 
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

This command first creates CIM sessions by using New-CimSession, and then gets the CIM sessions by using Get-CimSession.

-------------------------- EXAMPLE xample 2: Get the CIM sessions from a specific computer --------------------------xample : Get the CIM sessions from a specific computer

PS C:\>Get-CimSession -ComputerName Server02
Id           : 2 


Name         : CimSession2 


InstanceId   : c0095981-52c5-4e7f-a5bb-c4c680541710 


ComputerName : Server02 


Protocol     : WSMAN

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

-------------------------- EXAMPLE xample 3: Get a list of CIM sessions and then format the list --------------------------xample : Get a list of CIM sessions and then format the list

PS C:\>Get-CimSession | Format-Table -Property ComputerName,InstanceID

This command gets all of the CIM sessions in the current wps_2 session, and then formats the list in a table containing only the ComputerName and InstanceID parameters.

-------------------------- EXAMPLExample 4: Get all the CIM sessions that have specific names --------------------------xample: Get all the CIM sessions that have specific names

PS C:\>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

This command gets all of the CIM sessions that have names that begin with the characters serv.

-------------------------- EXAMPLExample 5: Get a specific CIM session --------------------------xample: Get a specific CIM session

PS C:\>Get-CimSession -ID 2

This command gets the CIM session that has an ID of 2.

Required Parameters

-Id

Specifies the identifier (ID) of the CIM session to get. For one or more 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 in the current wps_2 session. It is easier to remember and type than InstanceId, but it is unique only within the current wps_2 session.

For more information about the range operator, see about_Operators.

Type:UInt32[]
Position:1
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-InstanceId

Specifies the instance IDs of the CIM session to get.

InstanceID is a GUID that uniquely identifies a CIM session. The InstanceID is unique, even when you have multiple sessions running in wps_2.

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

Type:Guid[]
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-Name

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

Type:String[]
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:True

Optional Parameters

-ComputerName

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

Type:String[]
Aliases:CN, ServerName
Position:1
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:True

Inputs

None

Outputs

Microsoft.Management.Infrastructure.CimSession