Remove-CimSession

  • Referencia
Módulo:
CimCmdlets

Quita una o varias sesiones CIM.

Syntax

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.

Type:CimSession[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:String[]
Aliases:CN, ServerName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:UInt32[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:Guid[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.