Remove-CimSession
Quita una o varias sesiones CIM.
Sintaxis
CimSessionSet (valor predeterminado)
Remove-CimSession
[-CimSession] <CimSession[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ComputerNameSet
Remove-CimSession
[-ComputerName] <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SessionIdSet
Remove-CimSession
[-Id] <UInt32[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InstanceIdSet
Remove-CimSession
-InstanceId <Guid[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
NameSet
Remove-CimSession
-Name <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
El cmdlet Remove-CimSession quita uno o varios objetos de sesión CIM de la sesión local de PowerShell.
Ejemplos
Ejemplo 1: Quitar todas las sesiones CIM
Get-CimSession | Remove-CimSession
Este comando recupera todas las sesiones CIM disponibles en el equipo local mediante el cmdlet Get-CimSession de
Ejemplo 2: Eliminación de una sesión CIM específica
Remove-CimSession -Id 5
Este comando quita la sesión CIM que tiene un valor de identificador de 5.
Ejemplo 3: Mostrar la lista de sesiones CIM que se van a quitar mediante el parámetro WhatIf
Remove-CimSession -Name a* -WhatIf
Este comando usa el parámetro común WhatIf para especificar que no se debe realizar la eliminación, sino solo generar lo que sucedería si se hiciera.
Parámetros
-CimSession
Especifica los objetos de las sesiones de CIM que se van a cerrar.
Escriba una variable que contenga la sesión CIM o un comando que cree o obtenga la sesión CIM, como los cmdlets New-CimSession o Get-CimSession.
Para obtener más información, consulte about_CimSessions.
Propiedades de parámetro
| Tipo: | CimSession[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
CimSessionSet
| Posición: | 0 |
| Obligatorio: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-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: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-Confirm
Le pide confirmación antes de ejecutar el cmdlet.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Id
Especifica el identificador de la sesión CIM que se va a quitar. Especifique uno o varios identificadores separados por comas 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 el identificador de instancia de la sesión CIM que se va a quitar.
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.
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
Especifica el nombre amigable de la sesión CIM que se va a quitar. Puede usar caracteres comodín con este parámetro.
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 |
-WhatIf
Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| 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.
Entradas
None
Este cmdlet no acepta objetos de entrada.
Salidas
Object
Este cmdlet devuelve un objeto que contiene información de sesión CIM.