Dela via


Remove-CimSession

Tar bort en eller flera CIM-sessioner.

Syntax

CimSessionSet (Standard)

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

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 hjälp av 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 CIM-sessionen 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 cmdletarna New-CimSession eller Get-CimSession. Mer information finns i about_CimSessions.

Parameteregenskaper

Typ:

CimSession[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

CimSessionSet
Position:0
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument: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.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:True
DontShow:False
Alias:CN, Servernamn

Parameteruppsättningar

ComputerNameSet
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Confirm

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

För mer information om intervalloperatorn, se about_Operators.

Parameteregenskaper

Typ:

UInt32[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SessionIdSet
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument: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 unik, även om du har flera sessioner som körs i PowerShell.

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

Parameteregenskaper

Typ:

Guid[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

InstanceIdSet
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Name

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

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:True
DontShow:False

Parameteruppsättningar

NameSet
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-WhatIf

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

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.