Get-CimSession

  • Referentie
Module:
CimCmdlets

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

Syntax

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

Description

Deze cmdlet is alleen beschikbaar op het Windows-platform.

De cmdlet haalt standaard alle CIM-sessies op die zijn gemaakt in de huidige PowerShell-sessie. U kunt de parameters gebruiken om de sessies op te halen die voor bepaalde computers zijn, of u kunt sessies identificeren op basis van Get-CimSession hun namen of andere id's. Get-CimSession krijgt geen CIM-sessies die zijn gemaakt in andere PowerShell-sessies of die zijn gemaakt op andere computers.

Zie about_CimSession voor meer informatie over CIM-sessies.

Voorbeelden

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

In dit voorbeeld worden CIM-sessies gemaakt met behulp van New-CimSession en worden vervolgens de CIM-sessies gebruikt.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

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

In dit voorbeeld worden de CIM-sessies ophaalt die zijn verbonden met de computer met de naam Server02.

Get-CimSession -ComputerName Server02

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

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

In dit voorbeeld worden alle CIM-sessies in de huidige PowerShell-sessie opgehaald en wordt een tabel weergegeven met alleen de eigenschappen ComputerName en InstanceID .

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

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

Voorbeeld 4: Alle CIM-sessies met specifieke namen ophalen

In dit voorbeeld worden alle CIM-sessies met namen weergegeven die beginnen met 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

Voorbeeld 5: Een specifieke CIM-sessie ophalen

In dit voorbeeld wordt de CIM-sessie met een id van 2 weergegeven.

Get-CimSession -ID 2

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

Parameters

-ComputerName

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

Type:String[]
Aliases:CN, ServerName
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-Id

Hiermee geeft u de id van de CIM-sessie op die moet worden get. Gebruik voor meerdere 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 binnen de huidige PowerShell-sessie.

Zie about_Operators voor meer informatie over de bereikoperator.

Type:UInt32[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-InstanceId

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

InstanceId is een GUID (Globally Unique Identifier) 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
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Required:True
Accept pipeline input:True
Accept wildcard characters:True

Invoerwaarden

None

U kunt geen objecten doorsluisen naar deze cmdlet.

Uitvoerwaarden

CimSession

Met deze cmdlet wordt een CIM-sessieobject geretourneerd.

Notities

PowerShell bevat de volgende aliassen voor Get-CimSession:

  • Windows:
    • gcms

Deze cmdlet is alleen beschikbaar op Windows-platforms.