Get-CimSession
Ruft die CIM-Sitzungsobjekte aus der aktuellen Sitzung ab.
Syntax
Get-CimSession
[[-ComputerName] <String[]>]
[<CommonParameters>]
Get-CimSession
[-Id] <UInt32[]>
[<CommonParameters>]
Get-CimSession
-InstanceId <Guid[]>
[<CommonParameters>]
Get-CimSession
-Name <String[]>
[<CommonParameters>]
Beschreibung
Dieses Cmdlet ist nur auf der Windows-Plattform verfügbar.
Standardmäßig ruft das Cmdlet alle CIM-Sitzungen ab, die in der aktuellen PowerShell-Sitzung erstellt wurden. Sie können die Parameter von Get-CimSession
verwenden, um die Sitzungen abzurufen, die für bestimmte Computer gelten, oder Sie können Sitzungen anhand ihrer Namen oder anderer Bezeichner identifizieren. Get-CimSession
ruft keine CIM-Sitzungen ab, die in anderen PowerShell-Sitzungen erstellt wurden oder die auf anderen Computern erstellt wurden.
Weitere Informationen zu CIM-Sitzungen finden Sie unter about_CimSession.
Beispiele
Beispiel 1: Abrufen von CIM-Sitzungen aus der aktuellen PowerShell-Sitzung
In diesem Beispiel werden CIM-Sitzungen mit New-CimSession erstellt und dann die CIM-Sitzungen mithilfe von Get-CimSession
abgerufen.
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
Beispiel 2: Abrufen der CIM-Sitzungen auf einen bestimmten Computer
In diesem Beispiel werden die CIM-Sitzungen abgerufen, die mit dem Computer server02 verbunden sind.
Get-CimSession -ComputerName Server02
Id : 2
Name : CimSession2
InstanceId : c0095981-52c5-4e7f-a5bb-c4c680541710
ComputerName : Server02
Protocol : WSMAN
Beispiel 3: Abrufen einer Liste von CIM-Sitzungen und Formatieren der Liste
In diesem Beispiel werden alle CIM-Sitzungen in der aktuellen PowerShell-Sitzung abgerufen und eine Tabelle angezeigt, die nur die Eigenschaften ComputerName und InstanceID enthält.
Get-CimSession | Format-Table -Property ComputerName,InstanceId
ComputerName InstanceId
------------ ----------
Server01 d1413bc3-162a-4cb8-9aec-4d2c61253d59
Server02 c0095981-52c5-4e7f-a5bb-c4c680541710
Beispiel 4: Abrufen aller CIM-Sitzungen mit bestimmten Namen
In diesem Beispiel werden alle CIM-Sitzungen mit Namen abgerufen, die mit serv beginnen.
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
Beispiel 5: Abrufen einer bestimmten CIM-Sitzung
In diesem Beispiel wird die CIM-Sitzung mit der ID 2 abgerufen.
Get-CimSession -ID 2
Id : 2
Name : CimSession2
InstanceId : c0095981-52c5-4e7f-a5bb-c4c680541710
ComputerName : Server02
Protocol : WSMAN
Parameter
-ComputerName
Gibt den Namen des Computers an, mit dem CIM-Sitzungen verbunden werden sollen. Platzhalterzeichen sind zulässig.
Type: | String[] |
Aliases: | CN, ServerName |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Id
Gibt den Bezeichner der abzurufenden CIM-Sitzung an. Verwenden Sie bei mehreren IDs Kommas, um die IDs zu trennen, oder verwenden Sie den Bereichsoperator (..
), um einen Bereich von IDs anzugeben. Eine ID ist eine ganze Zahl, die die CIM-Sitzung innerhalb der aktuellen PowerShell-Sitzung eindeutig identifiziert.
Weitere Informationen zum Bereichsoperator finden Sie unter about_Operators.
Type: | UInt32[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InstanceId
Gibt die instance IDs der cim-Sitzung an, die abgerufen werden sollen.
InstanceId ist ein global eindeutiger Bezeichner (GUID), der eine CIM-Sitzung eindeutig identifiziert. Die InstanceId ist eindeutig, auch wenn mehrere Sitzungen in PowerShell ausgeführt werden.
Die InstanceId wird in der InstanceId-Eigenschaft des Objekts gespeichert, das eine CIM-Sitzung darstellt.
Type: | Guid[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Ruft mindestens eine CIM-Sitzung ab, die die angegebenen Anzeigenamen enthalten. Platzhalterzeichen sind zulässig.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
Eingaben
None
Sie können keine Objekte an dieses Cmdlet übergeben.
Ausgaben
Dieses Cmdlet gibt ein CIM-Sitzungsobjekt zurück.
Hinweise
PowerShell enthält die folgenden Aliase für Get-CimSession
:
- Windows:
gcms
Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar.