Sdílet prostřednictvím

Get-CimSession

Modul:
CimCmdlets Module

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

Syntaxe

ComputerNameSet (Výchozí) 

Get-CimSession
    [[-ComputerName] <String[]>]
    [<CommonParameters>]

SessionIdSet 

Get-CimSession
    [-Id] <UInt32[]>
    [<CommonParameters>]

InstanceIdSet 

Get-CimSession
    -InstanceId <Guid[]>
    [<CommonParameters>]

NameSet 

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, které byly vytvořeny 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ů nebo jiných identifikátorů. Get-CimSession nezíská CIM relace vytvořené v jiných relacích PowerShellu nebo vytvořené na 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-CimSessiona 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 ComputerName a InstanceId vlastnosti.

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.

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:True
DontShow:False
Aliasy:Čína, Název serveru

Sady parametrů

ComputerNameSet
Position:0
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-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 naleznete v tématu about_Operators.

Vlastnosti parametru

Typ:

UInt32[]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

SessionIdSet
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-InstanceId

Určuje ID instancí relace CIM, které mají být získány.

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

InstanceId je uložen ve vlastnosti InstanceId objektu, který představuje relaci CIM.

Vlastnosti parametru

Typ:

Guid[]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

InstanceIdSet
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-Name

Získá jednu nebo více relací CIM, které obsahují zadané přátelské názvy. Jsou povoleny zástupné znaky.

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:True
DontShow:False

Sady parametrů

NameSet
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

None

Do tohoto cmdletu nemůžete předávat objekty.

Výstupy

CimSession

Tento cmdlet vrátí objekt relace CIM.

Poznámky

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

  • Windows:
    • gcms

Tento cmdlet je dostupný pouze na platformách Windows.