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í Remove-CimSession.

Get-CimSession | Remove-CimSession

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

Tento příklad odebere relaci CIM, která má id hodnotu 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 určit, že odebrání by se nemělo provést, 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 New-CimSession nebo Get-CimSession rutiny. Další informace naleznete 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 vás vyzve 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 naleznete 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žen v InstanceId vlastnost 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

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

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.