Remove-CimSession

Tar bort en eller flera CIM-sessioner.

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

Den här cmdleten är endast tillgänglig på Windows-plattformen.

Cmdleten Remove-CimSession tar bort ett eller flera CIM-sessionsobjekt från den lokala PowerShell-sessionen.

Exempel

Exempel 1: Ta bort alla CIM-sessioner

Det här exemplet hämtar alla tillgängliga CIM-sessioner på den lokala datorn med cmdleten Get-CimSession och tar sedan bort dem med hjälp av Remove-CimSession.

Get-CimSession | Remove-CimSession

Exempel 2: Ta bort en specifik CIM-session

Det här exemplet tar bort den CIM-session som har ett ID-värde på 5.

Remove-CimSession -Id 5

Exempel 3: Visa listan över CIM-sessioner att ta bort med hjälp av parametern WhatIf

I det här exemplet används den gemensamma parametern WhatIf för att ange att borttagningen inte ska göras, utan endast utdata vad som skulle hända om det gjordes.

Remove-CimSession -Name a* -WhatIf

Parametrar

-CimSession

Anger sessionsobjekten för de CIM-sessioner som ska stängas.

Ange en variabel som innehåller CIM-sessionen eller ett kommando som skapar eller hämtar CIM-sessionen, till exempel New-CimSession cmdletarna eller Get-CimSession . Mer information finns i about_CimSessions.

Typ:CimSession[]
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ComputerName

Anger en matris med namn på datorer. Tar bort de sessioner som ansluter till de angivna datorerna. Du kan ange ett fullständigt kvalificerat domännamn (FQDN) eller ett NetBIOS-namn.

Typ:String[]
Alias:CN, ServerName
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:True

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Id

Anger ID för den CIM-session som ska tas bort. Ange ett eller flera ID:t avgränsade med kommatecken eller använd intervalloperatorn (..) för att ange ett intervall med ID:er. Ett ID är ett heltal som unikt identifierar CIM-sessionen i den aktuella PowerShell-sessionen.

Mer information om intervalloperatorn finns i about_Operators.

Typ:UInt32[]
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-InstanceId

Anger instans-ID för CIM-sessionen som ska ta bort. InstanceId är en globalt unik identifierare (GUID) som unikt identifierar en CIM-session. InstanceId är unikt, även om du har flera sessioner som körs i PowerShell.

InstanceId lagras i egenskapen InstanceId för objektet som representerar en CIM-session.

Typ:Guid[]
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Name

Anger det egna namnet på den CIM-session som ska tas bort. Du kan använda jokertecken med den här parametern.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:True

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

None

Du kan inte skicka objekt till den här cmdleten.

Utdata

Object

Den här cmdleten returnerar ett objekt som innehåller CIM-sessionsinformation.

Kommentarer

PowerShell innehåller följande alias för Remove-CimSession:

  • Windows:
    • rcms

Den här cmdleten är endast tillgänglig på Windows-plattformar.