Delen via

Get-CimSession

  • Referentie
Module:
CimCmdlets

Hiermee haalt u de CIM-sessieobjecten op uit de huidige sessie.

Syntaxis

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

Description

Met de Get-CimSession cmdlet worden de CIM-sessieobjecten opgehaald die zijn gemaakt in de huidige PowerShell-sessie.

Als deze zonder parameters wordt gebruikt, haalt de cmdlet alle CIM-sessies op die zijn gemaakt in de huidige PowerShell-sessie. U kunt de parameters van Get-CimSession gebruiken om de sessies op te halen die voor bepaalde computers zijn, of u kunt sessies identificeren op basis van hun namen, id's of exemplaar-id's.

Zie about_CimSessionvoor meer informatie over PowerShell-sessies.

Voorbeelden

Voorbeeld 1: CIM-sessies ophalen uit de huidige PowerShell-sessie

Standaard krijgt Get-CimSession alleen informatie over de CIM-sessies die aanwezig zijn in de huidige PowerShell-sessie. Get-CimSession geen CIM-sessies krijgt die zijn gemaakt in andere PowerShell-sessies of die zijn gemaakt op andere computers.

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

Met deze opdracht maakt u eerst CIM-sessies met behulp van New-CimSessionen haalt u vervolgens de CIM-sessies op met behulp van Get-CimSession.

Voorbeeld 2: De CIM-sessies ophalen op een specifieke computer

Get-CimSession -ComputerName Server02

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

Met deze opdracht worden de CIM-sessies ophaalt die zijn verbonden met de computer met de naam Server02.

Voorbeeld 3: Een lijst met CIM-sessies ophalen en vervolgens de lijst opmaken

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

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

Met deze opdracht worden alle CIM-sessies in de huidige PowerShell-sessie opgehaald en wordt de lijst vervolgens opgemaakt in een tabel met alleen de eigenschappen ComputerName en InstanceID.

Voorbeeld 4: Alle CIM-sessies met specifieke namen ophalen

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

Met deze opdracht worden alle CIM-sessies met namen die beginnen met de tekens serv.

Voorbeeld 5: Een specifieke CIM-sessie ophalen

Get-CimSession -ID 2

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

Met deze opdracht wordt de CIM-sessie met een id van 2 ophaalt.

Parameters

-ComputerName

Hiermee geeft u de naam van de computer om CIM-sessies verbinding te maken met. Jokertekens zijn toegestaan.

Type:String[]
Aliassen:CN, ServerName
Position:0
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:True

-Id

Hiermee geeft u de id (ID) van de CIM-sessie op die moet worden get. Gebruik voor een of meer id's komma's om de id's te scheiden of gebruik de bereikoperator (..) om een bereik van id's op te geven.

Een id is een geheel getal dat de CIM-sessie uniek identificeert in de huidige PowerShell-sessie. Het is gemakkelijker om te onthouden en te typen dan InstanceId, maar het is alleen uniek binnen de huidige PowerShell-sessie.

Zie about_Operatorsvoor meer informatie over de bereikoperator.

Type:UInt32[]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-InstanceId

Hiermee geeft u de exemplaar-id's van de CIM-sessie op die moeten worden opgehaald.

InstanceId is een GUID die een CIM-sessie uniek identificeert. De InstanceId is uniek, zelfs wanneer er meerdere sessies worden uitgevoerd in PowerShell.

De InstanceId wordt opgeslagen in de eigenschap InstanceId van het object dat een CIM-sessie vertegenwoordigt.

Type:Guid[]
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

Hiermee haalt u een of meer CIM-sessies op die de opgegeven beschrijvende namen bevatten. Jokertekens zijn toegestaan.

Type:String[]
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:True

Invoerwaarden

None

Uitvoerwaarden

CimSession