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

Rutina Get-CimSession získá objekty relace CIM vytvořené v aktuální relaci PowerShellu.

Pokud se používá bez parametrů, rutina získá všechny relace CIM vytvořené v aktuální relaci PowerShellu. Pomocí parametrů Get-CimSession můžete získat relace, které jsou určené pro konkrétní počítače, nebo můžete relace identifikovat podle jejich názvů, ID nebo ID instancí.

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

Příklady

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

Ve výchozím nastavení Get-CimSession získá pouze informace o relacích CIM, které existují v aktuální relaci PowerShellu. Get-CimSession nezískute relace CIM vytvořené v jiných relacích PowerShellu nebo vytvořených v jiných počítačích.

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

Tento příkaz nejprve vytvoří relace CIM pomocí New-CimSessiona pak získá relace CIM pomocí Get-CimSession.

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

Get-CimSession -ComputerName Server02

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

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

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

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

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

Tento příkaz získá všechny relace CIM v aktuální relaci PowerShellu a pak formátuje seznam v tabulce obsahující pouze vlastnosti ComputerName a Instance ID.

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

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

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

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

Get-CimSession -ID 2

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

Tento příkaz získá relaci CIM s ID 2.

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 (ID) relace CIM, který se má získat. U jednoho nebo 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. Je snazší si zapamatovat a zadat typ než InstanceId, ale je jedinečný pouze v rámci aktuální relace 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 instancí relace CIM, která se má získat.

InstanceId je 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

Výstupy

CimSession