Remove-CimSession

  • Referentie
Module:
CimCmdlets

Hiermee verwijdert u een of meer CIM-sessies.

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

Deze cmdlet is alleen beschikbaar op het Windows-platform.

De Remove-CimSession cmdlet verwijdert een of meer CIM-sessieobjecten uit de lokale PowerShell-sessie.

Voorbeelden

Voorbeeld 1: Alle CIM-sessies verwijderen

In dit voorbeeld worden alle beschikbare CIM-sessies opgehaald op de lokale computer met behulp van de Get-CimSession-cmdlet en worden ze vervolgens verwijderd met behulp van de Remove-CimSession.

Get-CimSession | Remove-CimSession

Voorbeeld 2: Een specifieke CIM-sessie verwijderen

In dit voorbeeld wordt de CIM-sessie met een id-waarde van 5 verwijderd.

Remove-CimSession -Id 5

Voorbeeld 3: De lijst met CIM-sessies weergeven die u wilt verwijderen met behulp van de parameter WhatIf

In dit voorbeeld wordt de algemene parameter WhatIf gebruikt om op te geven dat de verwijdering niet moet worden uitgevoerd, maar wordt alleen uitgevoerd wat er zou gebeuren als dit zou gebeuren.

Remove-CimSession -Name a* -WhatIf

Parameters

-CimSession

Hiermee geeft u de sessieobjecten van de CIM-sessies te sluiten.

Voer een variabele in die de CIM-sessie bevat of een opdracht waarmee de CIM-sessie wordt gemaakt of ophaalt, zoals de New-CimSession of Get-CimSession cmdlets. Zie about_CimSessions voor meer informatie.

Type:CimSession[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputerName

Hiermee geeft u een matrix van namen van computers. Hiermee verwijdert u de sessies die verbinding maken met de opgegeven computers. U kunt een FQDN (Fully Qualified Domain Name) of een NetBIOS-naam opgeven.

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

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Hiermee geeft u de id van de CIM-sessie die moet worden verwijderd. Geef een of meer id's op, gescheiden door komma's, of gebruik de bereikoperator (..) om een bereik van id's op te geven. Een id is een geheel getal dat de CIM-sessie uniek identificeert in de huidige PowerShell-sessie.

Zie about_Operators voor meer informatie over de bereikoperator.

Type:UInt32[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-InstanceId

Hiermee geeft u de exemplaar-id van de CIM-sessie die moet worden verwijderd. InstanceId is een GUID (Globally Unique Identifier) die een CIM-sessie uniek identificeert. De InstanceId is uniek, zelfs wanneer er meerdere sessies worden uitgevoerd in PowerShell.

De InstanceId wordt opgeslagen in de eigenschap InstanceId van het object dat een CIM-sessie vertegenwoordigt.

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

-Name

Hiermee geeft u de beschrijvende naam van de CIM-sessie te verwijderen. U kunt jokertekens gebruiken met deze parameter.

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

None

U kunt geen objecten doorsluisen naar deze cmdlet.

Uitvoerwaarden

Object

Met deze cmdlet wordt een object geretourneerd dat CIM-sessiegegevens bevat.

Notities

PowerShell bevat de volgende aliassen voor Remove-CimSession:

  • Windows:
    • rcms

Deze cmdlet is alleen beschikbaar op Windows-platforms.