Get-CimSession

Modul:
CimCmdlets Module

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

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 Get-CimSession verwenden, um die Sitzungen abzurufen, die sich für bestimmte Computer befinden, 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 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 mithilfe von New-CimSession erstellt, und anschließend werden die CIM-Sitzungen mithilfe von Get-CimSessionCIM-Sitzungen erstellt.

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 mit dem Namen 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 ab, 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 einer ID von 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.

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 der CIM-Sitzung an, die abgerufen werden soll. Verwenden Sie für 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 innerhalb der aktuellen PowerShell-Sitzung eindeutig identifiziert.

Weitere Informationen zum 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 (Globally Unique Identifier), 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.

Eingaben

None

Sie können keine Objekte an dieses Cmdlet weiterleiten.

Ausgaben

CimSession

Dieses Cmdlet gibt ein CIM-Sitzungsobjekt zurück.

Hinweise

PowerShell enthält die folgenden Aliase für Get-CimSession:

  • Fenster:
    • gcms

Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar.