Compartir a través de

Remove-CimSession

  • Referencia
Módulo:
CimCmdlets

Quita una o varias sesiones CIM.

Sintaxis

Remove-CimSession
      [-CimSession] <CimSession[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CimSession
      [-ComputerName] <String[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CimSession
      [-Id] <UInt32[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CimSession
      -InstanceId <Guid[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CimSession
      -Name <String[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Este cmdlet solo está disponible en la plataforma Windows.

El Remove-CimSession cmdlet quita uno o varios objetos de sesión CIM de la sesión local de PowerShell.

Ejemplos

Ejemplo 1: Quitar todas las sesiones CIM

En este ejemplo se recuperan todas las sesiones CIM disponibles en el equipo local mediante el cmdlet Get-CimSession y, a continuación, se quitan mediante Remove-CimSession.

Get-CimSession | Remove-CimSession

Ejemplo 2: Eliminación de una sesión CIM específica

En este ejemplo se quita la sesión CIM que tiene un valor id . de 5.

Remove-CimSession -Id 5

Ejemplo 3: Mostrar la lista de sesiones CIM que se van a quitar mediante el parámetro WhatIf

En este ejemplo se 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.

Remove-CimSession -Name a* -WhatIf

Parámetros

-CimSession

Especifica los objetos de sesión de las sesiones 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 New-CimSession cmdlets o Get-CimSession . Para obtener más información, consulte about_CimSessions.

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

-ComputerName

Especifica una matriz de nombres de equipos. Quita las sesiones que se conectan a los equipos especificados. Puede especificar un nombre de dominio completo (FQDN) o un nombre NetBIOS.

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

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

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

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

-Name

Especifica el nombre descriptivo de la sesión CIM que se va a quitar. Puede usar caracteres comodín con este parámetro.

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

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

None

No se pueden canalizar objetos a este cmdlet.

Salidas

Object

Este cmdlet devuelve un objeto que contiene información de sesión CIM.

Notas

PowerShell incluye los siguientes alias para Remove-CimSession:

  • Windows:
    • rcms

Este cmdlet solo está disponible en plataformas Windows.