Get-CimSession
Ruft die CIM-Sitzungsobjekte aus der aktuellen Sitzung ab.
Syntax
ComputerNameSet (Standard)
Get-CimSession
[[-ComputerName] <String[]>]
[<CommonParameters>]
SessionIdSet
Get-CimSession
[-Id] <UInt32[]>
[<CommonParameters>]
InstanceIdSet
Get-CimSession
-InstanceId <Guid[]>
[<CommonParameters>]
NameSet
Get-CimSession
-Name <String[]>
[<CommonParameters>]
Beschreibung
Das Cmdlet Get-CimSession ruft die CIM-Sitzungsobjekte ab, die in der aktuellen PowerShell-Sitzung erstellt wurden.
Wenn das Cmdlet ohne Parameter verwendet wird, werden alle CIM-Sitzungen abgerufen, die in der aktuellen PowerShell-Sitzung erstellt wurden.
Sie können die Parameter von Get-CimSession verwenden, um die Sitzungen abzurufen, die sich für bestimmte Computer befinden, oder Sie können Sitzungen anhand ihrer Namen, IDs oder Instanz-IDs identifizieren.
Weitere Informationen zu PowerShell-Sitzungen finden Sie unter about_CimSession.
Beispiele
Beispiel 1: Abrufen von CIM-Sitzungen aus der aktuellen PowerShell-Sitzung
Standardmäßig ruft Get-CimSession nur Informationen zu den CIM-Sitzungen ab, die in der aktuellen PowerShell-Sitzung vorhanden sind.
Get-CimSession erhalten keine CIM-Sitzungen, die in anderen PowerShell-Sitzungen erstellt wurden oder auf anderen Computern erstellt wurden.
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
Dieser Befehl erstellt zunächst CIM-Sitzungen mithilfe New-CimSessionund ruft dann die CIM-Sitzungen mithilfe von Get-CimSessionab.
Beispiel 2: Abrufen der CIM-Sitzungen auf einen bestimmten Computer
Get-CimSession -ComputerName Server02
Id : 2
Name : CimSession2
InstanceId : c0095981-52c5-4e7f-a5bb-c4c680541710
ComputerName : Server02
Protocol : WSMAN
Dieser Befehl ruft die CIM-Sitzungen ab, die mit dem Computer mit dem Namen Server02 verbunden sind.
Beispiel 3: Abrufen einer Liste von CIM-Sitzungen und Formatieren der Liste
Get-CimSession | Format-Table -Property ComputerName,InstanceId
ComputerName InstanceId
------------ ----------
Server01 d1413bc3-162a-4cb8-9aec-4d2c61253d59
Server02 c0095981-52c5-4e7f-a5bb-c4c680541710
Dieser Befehl ruft alle CIM-Sitzungen in der aktuellen PowerShell-Sitzung ab und formatiert dann die Liste in einer Tabelle, die nur die eigenschaften ComputerName und InstanceID enthält.
Beispiel 4: Alle CIM-Sitzungen mit bestimmten Namen abrufen
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
Dieser Befehl ruft alle CIM-Sitzungen mit Namen ab, die mit den Zeichen serv beginnen.
Beispiel 5: Abrufen einer bestimmten CIM-Sitzung
Get-CimSession -ID 2
Id : 2
Name : CimSession2
InstanceId : c0095981-52c5-4e7f-a5bb-c4c680541710
ComputerName : Server02
Protocol : WSMAN
Dieser Befehl ruft die CIM-Sitzung mit einer ID von 2 ab.
Parameter
-ComputerName
Gibt den Namen des Computers an, mit dem CIM-Sitzungen verbunden werden sollen. Platzhalterzeichen sind zulässig.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | True |
| Nicht anzeigen: | False |
| Aliase: | China, Servername |
Parametersätze
ComputerNameSet
| Position: | 0 |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Id
Gibt den Bezeichner (ID) der CIM-Sitzung an, die abgerufen werden soll. Verwenden Sie für eine oder mehrere 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 in der aktuellen PowerShell-Sitzung eindeutig identifiziert. Es ist einfacher zu merken und einzugeben als InstanceId, aber es ist nur innerhalb der aktuellen PowerShell-Sitzung eindeutig.
Weitere Informationen über den Bereichsoperator finden Sie unter about_Operators.
Parametereigenschaften
| Typ: | UInt32[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
SessionIdSet
| Position: | 0 |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-InstanceId
Gibt die Instanz-IDs der CIM-Sitzung an, die abgerufen werden sollen.
InstanceId ist eine GUID, die 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.
Parametereigenschaften
| Typ: | Guid[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
InstanceIdSet
| Position: | Named |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Name
Ruft eine oder mehrere CIM-Sitzungen ab, die die angegebenen Anzeigenamen enthalten. Platzhalterzeichen sind zulässig.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | True |
| Nicht anzeigen: | False |
Parametersätze
NameSet
| Position: | Named |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.