Get-CimSession

  • Referencia
Módulo:
CimCmdlets

Obtiene los objetos de sesión CIM de la sesión actual.

Sintaxis

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

Description

Este cmdlet solo está disponible en la plataforma Windows.

De forma predeterminada, el cmdlet obtiene todas las sesiones CIM creadas en la sesión actual de PowerShell. Puede usar los parámetros de Get-CimSession para obtener las sesiones que son para equipos concretos o puede identificar sesiones por sus nombres u otros identificadores. Get-CimSession no obtiene sesiones CIM que se crearon en otras sesiones de PowerShell o que se crearon en otros equipos.

Para obtener más información sobre las sesiones CIM, consulte about_CimSession.

Ejemplos

Ejemplo 1: Obtención de sesiones CIM de la sesión actual de PowerShell

En este ejemplo se crean sesiones CIM con New-CimSession y, a continuación, se obtienen las sesiones CIM mediante 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

Ejemplo 2: Obtener las sesiones CIM en un equipo específico

En este ejemplo se obtienen las sesiones CIM que están conectadas al equipo denominado Server02.

Get-CimSession -ComputerName Server02

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

Ejemplo 3: Obtener una lista de sesiones CIM y, a continuación, dar formato a la lista

En este ejemplo se obtienen todas las sesiones CIM de la sesión actual de PowerShell y se muestra una tabla que contiene solo las propiedades ComputerName e InstanceID .

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

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

Ejemplo 4: Obtener todas las sesiones CIM que tienen nombres específicos

En este ejemplo se obtienen todas las sesiones CIM que tienen nombres que comienzan por 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

Ejemplo 5: Obtener una sesión CIM específica

En este ejemplo se obtiene la sesión CIM que tiene un identificador de 2.

Get-CimSession -ID 2

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

Parámetros

-ComputerName

Especifica el nombre del equipo al que se van a conectar las sesiones CIM. Se permite el uso de caracteres comodín.

Tipo:String[]
Alias:CN, ServerName
Posición:0
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:True

-Id

Especifica el identificador de la sesión CIM que se va a obtener. Para varios identificadores, use comas para separar los identificadores o usar el operador de intervalo (..) para especificar un intervalo de identificadores. Un identificador es un entero que identifica de forma única la sesión CIM dentro de la sesión actual de PowerShell.

Para obtener más información sobre el operador range, consulte about_Operators.

Tipo:UInt32[]
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-InstanceId

Especifica los identificadores de instancia de la sesión CIM que se van a obtener.

InstanceId es un identificador único global (GUID) que identifica de forma única una sesión CIM. InstanceId es único, incluso cuando se ejecutan varias sesiones en PowerShell.

InstanceId se almacena en la propiedad InstanceId del objeto que representa una sesión CIM.

Tipo:Guid[]
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Name

Obtiene una o varias sesiones CIM que contienen los nombres descriptivos especificados. Se permite el uso de caracteres comodín.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:True

Entradas

None

No se pueden canalizar objetos a este cmdlet.

Salidas

CimSession

Este cmdlet devuelve un objeto de sesión CIM.

Notas

PowerShell incluye los siguientes alias para Get-CimSession:

  • Windows:
    • gcms

Este cmdlet solo está disponible en plataformas Windows.