Get-CimSession
Haalt 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.
Standaard haalt de cmdlet alle CIM-sessies op die in de huidige PowerShell-sessie zijn gemaakt. U kunt de parameters van 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, waarna de CIM-sessies worden ophaalt met behulp van 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: CIM-sessies ophalen naar een specifieke computer
In dit voorbeeld worden de CIM-sessies ophaalt die zijn verbonden met de computer 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 de lijst vervolgens 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 ophalen die specifieke namen hebben
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 opgehaald met een id van 2.
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 op van de computer waarmee CIM-sessies moeten worden verbonden. 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 te halen. 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 binnen de huidige PowerShell-sessie uniek identificeert.
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 instantie-id's van de CIM-sessie op die moeten worden opgehaald.
InstanceId is een GUID (Globally Unique Identifier) waarmee een CIM-sessie uniek wordt geïdentificeerd. 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 doorspezen naar deze cmdlet.
Uitvoerwaarden
Deze cmdlet retourneert een CIM-sessieobject.
Notities
PowerShell bevat de volgende aliassen voor Get-CimSession
:
- Windows:
gcms
Deze cmdlet is alleen beschikbaar op Windows-platforms.