Delen via

Get-CimSession

Module:
CimCmdlets Module

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

Syntaxis

ComputerNameSet (Standaard) 

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

SessionIdSet 

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

InstanceIdSet 

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

NameSet 

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 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 of andere id's. Get-CimSession krijgt geen toegang tot CIM-sessies die zijn aangemaakt in andere PowerShell-sessies of op andere computers.

Zie about_CimSessionvoor meer informatie over CIM-sessies.

Voorbeelden

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

In dit voorbeeld worden CIM-sessies gemaakt met New-CimSessionen vervolgens opgehaald met 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 getoond die zijn verbonden met de computer genaamd 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 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 weergegeven die een Id heeft van 2.

Get-CimSession -Id 2

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

Parameters

-ComputerName

Hiermee specificeert u de naam van de computer waarop u verbinding wilt maken met CIM-sessies. Jokertekens zijn toegestaan.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:True
DontShow:False
Aliassen:China, Servernaam

Parametersets

ComputerNameSet
Position:0
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Id

Hiermee geeft u de id van de CIM-sessie op die moet worden verkregen. 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.

Voor meer informatie over de operator voor bereik, zie about_Operators.

Parametereigenschappen

Type:

UInt32[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SessionIdSet
Position:0
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:

Guid[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

InstanceIdSet
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Name

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

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:True
DontShow:False

Parametersets

NameSet
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

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.