Freigeben über

Get-CimSession

  • Referenz
Modul:
CimCmdlets

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

Das Cmdlet Get-CimSession ruft die CIM-Sitzungsobjekte ab, die in der aktuellen PowerShell-Sitzung erstellt wurden.

Bei Verwendung ohne Parameter 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, IDs oder instance IDs identifizieren.

Weitere Informationen zu PowerShell-Sitzungen finden Sie unter about_CimSession.

Beispiele

Beispiel 1: Abrufen von CIM-Sitzungen aus der aktuellen PowerShell-Sitzung

Ruft standardmäßig nur Informationen zu den CIM-Sitzungen ab, Get-CimSession die in der aktuellen PowerShell-Sitzung vorhanden sind. Get-CimSession erhält keine CIM-Sitzungen, die in anderen PowerShell-Sitzungen erstellt 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 von New-CimSession und ruft dann die CIM-Sitzungen mithilfe Get-CimSessionvon ab.

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 anschließendes 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 die Liste dann in einer Tabelle, die nur die Eigenschaften ComputerName und InstanceID enthält.

Beispiel 4: Abrufen aller CIM-Sitzungen mit bestimmten Namen

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 ab, deren Namen 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 ab, die über die ID 2 verfügt.

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 (ID) der abzurufenden CIM-Sitzung an. 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 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 abzurufenden CIM-Sitzung an.

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.

Type:Guid[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Ruft eine oder mehrere CIM-Sitzungen 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

Ausgaben

CimSession