Get-CimSession
Obtiene los objetos de sesión CIM de la sesión actual.
Sintaxis
ComputerNameSet (valor predeterminado)
Get-CimSession
[[-ComputerName] <String[]>]
[<CommonParameters>]
SessionIdSet
Get-CimSession
[-Id] <UInt32[]>
[<CommonParameters>]
InstanceIdSet
Get-CimSession
-InstanceId <Guid[]>
[<CommonParameters>]
NameSet
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 desde 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
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 permite el uso de caracteres comodín.
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | True |
| DontShow: | False |
| Alias: | CN, NombreDelServidor |
Conjuntos de parámetros
ComputerNameSet
| Posición: | 0 |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-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 rango, consulte about_Operators.
Propiedades de parámetro
| Tipo: | UInt32[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
SessionIdSet
| Posición: | 0 |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-InstanceId
Especifica los identificadores de instancia que se van a obtener de la sesión CIM.
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.
Propiedades de parámetro
| Tipo: | Guid[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
InstanceIdSet
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-Name
Obtiene una o varias sesiones CIM que contienen los nombres descriptivos especificados. Se permite el uso de caracteres comodín.
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | True |
| DontShow: | False |
Conjuntos de parámetros
NameSet
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.