Sdílet prostřednictvím

Get-CimSession

  • Reference
Modul:
CimCmdlets

Získá objekty relace CIM z aktuální relace.

Syntaxe

Get-CimSession
   [[-ComputerName] <String[]>]
   [<CommonParameters>]
Get-CimSession
   [-Id] <UInt32[]>
   [<CommonParameters>]
Get-CimSession
   -InstanceId <Guid[]>
   [<CommonParameters>]
Get-CimSession
   -Name <String[]>
   [<CommonParameters>]

Description

Tato rutina je dostupná jenom na platformě Windows.

Ve výchozím nastavení rutina získá všechny relace CIM vytvořené v aktuální relaci PowerShellu. Parametry můžete použít Get-CimSession k získání relací, které jsou určené pro konkrétní počítače, nebo můžete relace identifikovat podle jejich názvů nebo jiných identifikátorů. Get-CimSession nezískáte relace CIM vytvořené v jiných relacích PowerShellu nebo vytvořených v jiných počítačích.

Další informace o relacích CIM najdete v tématu about_CimSession.

Příklady

Příklad 1: Získání relací CIM z aktuální relace PowerShellu

Tento příklad vytvoří relace CIM pomocí New-CimSession a pak získá relace CIM pomocí Get-CimSession.

New-CimSession -ComputerName Server01,Server02
Get-CimSession

Id           : 1
Name         : CimSession1
InstanceId   : d1413bc3-162a-4cb8-9aec-4d2c61253d59
ComputerName : Server01
Protocol     : WSMAN

Id           : 2
Name         : CimSession2
InstanceId   : c0095981-52c5-4e7f-a5bb-c4c680541710
ComputerName : Server02
Protocol     : WSMAN

Příklad 2: Získání relací CIM do konkrétního počítače

Tento příklad získá relace CIM připojené k počítači s názvem Server02.

Get-CimSession -ComputerName Server02

Id           : 2
Name         : CimSession2
InstanceId   : c0095981-52c5-4e7f-a5bb-c4c680541710
ComputerName : Server02
Protocol     : WSMAN

Příklad 3: Získání seznamu relací CIM a následné formátování seznamu

Tento příklad získá všechny relace CIM v aktuální relaci PowerShellu a zobrazí tabulku obsahující pouze vlastnosti ComputerName a InstanceID .

Get-CimSession | Format-Table -Property ComputerName,InstanceId

ComputerName InstanceId
------------ ----------
Server01     d1413bc3-162a-4cb8-9aec-4d2c61253d59
Server02     c0095981-52c5-4e7f-a5bb-c4c680541710

Příklad 4: Získání všech relací CIM s konkrétními názvy

Tento příklad získá všechny relace CIM, které mají názvy začínající serv.

Get-CimSession -ComputerName Serv*

Id           : 1
Name         : CimSession1
InstanceId   : d1413bc-162a-4cb8-9aec-4d2c61253d59
ComputerName : Server01
Protocol     : WSMAN

Id           : 2
Name         : CimSession2
InstanceId   : c0095981-52c5-4e7f-a5bb-c4c680541710
ComputerName : Server02
Protocol     : WSMAN

Příklad 5: Získání konkrétní relace CIM

Tento příklad získá relaci CIM, která má ID 2.

Get-CimSession -ID 2

Id           : 2
Name         : CimSession2
InstanceId   : c0095981-52c5-4e7f-a5bb-c4c680541710
ComputerName : Server02
Protocol     : WSMAN

Parametry

-ComputerName

Určuje název počítače, ke kterému se mají připojit relace CIM. Jsou povoleny zástupné znaky.

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

-Id

Určuje identifikátor relace CIM, který se má získat. U více ID použijte čárky k oddělení ID 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 instancí relace CIM, která se má získat.

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

Získá jednu nebo více relací CIM, které obsahují zadané popisné názvy. Jsou povoleny 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

Vstupy

None

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

Výstupy

CimSession

Tato rutina vrátí objekt relace CIM.

Poznámky

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

  • Windows:
    • gcms

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