Sdílet prostřednictvím

Remove-CimSession

  • Reference
Modul:
CimCmdlets

Odebere jednu nebo více relací CIM.

Syntaxe

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

Tato rutina je dostupná jenom na platformě Windows.

Rutina Remove-CimSession odebere jeden nebo více objektů relace CIM z místní relace PowerShellu.

Příklady

Příklad 1: Odebrání všech relací CIM

Tento příklad načte všechny dostupné relace CIM na místním počítači pomocí rutiny Get-CimSession a pak je odebere pomocí příkazu Remove-CimSession.

Get-CimSession | Remove-CimSession

Příklad 2: Odebrání konkrétní relace CIM

Tento příklad odebere relaci CIM s hodnotou ID 5.

Remove-CimSession -Id 5

Příklad 3: Zobrazení seznamu relací CIM, které se mají odebrat pomocí parametru WhatIf

Tento příklad používá společný parametr WhatIf k určení, že odebrání by nemělo být provedeno, ale pouze výstup, co by se stalo, kdyby bylo provedeno.

Remove-CimSession -Name a* -WhatIf

Parametry

-CimSession

Určuje objekty relace relací relací CIM, které se mají zavřít.

Zadejte proměnnou, která obsahuje relaci CIM, nebo příkaz, který vytvoří nebo získá relaci CIM, například rutinyNew-CimSession.Get-CimSession Další informace najdete v tématu about_CimSessions.

Typ:CimSession[]
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ComputerName

Určuje pole názvů počítačů. Odebere relace, které se připojují k zadaným počítačům. Můžete zadat plně kvalifikovaný název domény (FQDN) nebo název rozhraní NetBIOS.

Typ:String[]
Aliasy:CN, ServerName
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:True

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Id

Určuje ID relace CIM, která se má odebrat. Zadejte jedno nebo více ID oddělených čárkami nebo pomocí operátoru rozsahu (..) zadejte rozsah ID. ID je celé číslo, které jednoznačně identifikuje relaci CIM v aktuální relaci PowerShellu.

Další informace o operátoru rozsahu najdete v tématu about_Operators.

Typ:UInt32[]
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-InstanceId

Určuje ID instance relace CIM, která se má odebrat. InstanceId je globálně jedinečný identifikátor (GUID), který jednoznačně identifikuje relaci CIM. Id instance je jedinečné, i když máte v PowerShellu spuštěných více relací.

InstanceId je uložena ve Vlastnosti InstanceId objektu, který představuje relaci CIM.

Typ:Guid[]
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Name

Určuje popisný název relace CIM, která se má odebrat. S tímto parametrem můžete použít zástupné znaky.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:True

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

None

Do této rutiny nemůžete roušit objekty.

Výstupy

Object

Tato rutina vrátí objekt, který obsahuje informace o relaci CIM.

Poznámky

PowerShell obsahuje následující aliasy pro Remove-CimSession:

  • Windows:
    • rcms

Tato rutina je dostupná jenom na platformách Windows.