Get-CimSession

Gets the CIM session objects from the current session.
Get-CimSession [[-ComputerName] <String[]>] [<CommonParameters>]
Get-CimSession [-Id*] <UInt32[]> [<CommonParameters>]
Get-CimSession -InstanceId* <Guid[]> [<CommonParameters>]
Get-CimSession -Name* <String[]> [<CommonParameters>]

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

Parameters
-ComputerName <String[]>

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

-Id <UInt32[]>

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.

-InstanceId <Guid[]>

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.

-Name <String[]>

  • This value is required
  • Accepts pipeline input ByPropertyName
  • Accepts wildcard characters

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

<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,ErrorAction, ErrorVariable, WarningAction, WarningVariable,OutBuffer, PipelineVariable, and OutVariable.

Inputs

None

Outputs

Microsoft.Management.Infrastructure.CimSession

Examples
  1. Get CIM sessions from the current wps_2 session.:
    1. This command first creates CIM sessions by using New-CimSession, and then gets the CIM sessions by using Get-CimSession:
      
         --------------------------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
      PS C:> Get-CimSession -ComputerName Server02
      Id           : 2
      
         Name         : CimSession2 
         InstanceId   : c0095981-52c5-4e7f-a5bb-c4c680541710 
         ComputerName : Server02 
         Protocol     : WSMAN

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

    2. This command gets the CIM sessions that are connected to the computer named Server02:
      PS C:> Get-CimSession | Format-Table -Property ComputerName,InstanceID
      

      ————————– 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 listThis 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.

  2. 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.

  3. Get a specific CIM session ————————–xample:
    
       specific CIM session
    
    PS C:> Get-CimSession -ID 2
    

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

Related Links

Format-Table
New-CimSession
Remove-CimSession