Compartir a través de

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

El cmdlet Get-CimSession obtiene los objetos de sesión CIM creados en la sesión actual de PowerShell.

Si se usa sin parámetros, 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 las sesiones por sus nombres, identificadores o identificadores de instancia.

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

Ejemplos

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

De forma predeterminada, Get-CimSession solo obtiene información sobre las sesiones CIM que existen en la sesión actual de PowerShell. Get-CimSession no obtiene sesiones CIM creadas en otras sesiones de PowerShell o que se crearon en otros equipos.

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

En primer lugar, este comando crea sesiones CIM mediante New-CimSessiony, a continuación, obtiene las sesiones CIM mediante Get-CimSession.

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

Get-CimSession -ComputerName Server02

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

Este comando obtiene las sesiones CIM que están conectadas al equipo denominado Server02.

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

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

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

Este comando obtiene todas las sesiones CIM de la sesión actual de PowerShell y, a continuación, da formato a la lista en una tabla que contiene solo las propiedades ComputerName de y InstanceID.

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

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

Este comando obtiene todas las sesiones CIM que tienen nombres que comienzan por los caracteres serv.

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

Get-CimSession -ID 2

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

Este comando obtiene la sesión CIM que tiene un identificador de 2.

Parámetros

-ComputerName

Especifica el nombre del equipo al que se van a conectar las sesiones CIM. Se permiten 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 (ID) de la sesión CIM que se va a obtener. Para uno o varios identificadores, use comas para separar los identificadores o use el operador de intervalo (..) para especificar un intervalo de identificadores.

Un identificador es un entero que identifica de forma única la sesión CIM en la sesión actual de PowerShell. Es más fácil recordar y escribir que InstanceId, pero solo es único dentro de la sesión actual de PowerShell.

Para obtener más información sobre el operador de intervalo, vea 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 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 permiten 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

Salidas

CimSession