Get-CimSession
Získá objekty relace CIM z aktuální relace.
Syntax
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
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.
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 (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.
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.
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.
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.