Dela via


Get-CimSession

Hämtar CIM-sessionsobjekten från den aktuella sessionen.

Syntax

Get-CimSession
   [[-ComputerName] <String[]>]
   [<CommonParameters>]
Get-CimSession
   [-Id] <UInt32[]>
   [<CommonParameters>]
Get-CimSession
   -InstanceId <Guid[]>
   [<CommonParameters>]
Get-CimSession
   -Name <String[]>
   [<CommonParameters>]

Description

Den här cmdleten är endast tillgänglig på Windows-plattformen.

Som standard hämtar cmdleten alla CIM-sessioner som skapats i den aktuella PowerShell-sessionen. Du kan använda parametrarna Get-CimSession för för att hämta de sessioner som är för vissa datorer, eller så kan du identifiera sessioner efter deras namn eller andra identifierare. Get-CimSession hämtar inte CIM-sessioner som har skapats i andra PowerShell-sessioner eller som har skapats på andra datorer.

Mer information om CIM-sessioner finns i about_CimSession.

Exempel

Exempel 1: Hämta CIM-sessioner från den aktuella PowerShell-sessionen

Det här exemplet skapar CIM-sessioner med New-CimSession och hämtar sedan CIM-sessionerna med .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

Exempel 2: Hämta CIM-sessioner till en specifik dator

Det här exemplet hämtar de CIM-sessioner som är anslutna till datorn med namnet Server02.

Get-CimSession -ComputerName Server02

Id           : 2
Name         : CimSession2
InstanceId   : c0095981-52c5-4e7f-a5bb-c4c680541710
ComputerName : Server02
Protocol     : WSMAN

Exempel 3: Hämta en lista över CIM-sessioner och formatera sedan listan

Det här exemplet hämtar alla CIM-sessioner i den aktuella PowerShell-sessionen och visar en tabell som endast innehåller egenskaperna ComputerName och InstanceID .

Get-CimSession | Format-Table -Property ComputerName,InstanceId

ComputerName InstanceId
------------ ----------
Server01     d1413bc3-162a-4cb8-9aec-4d2c61253d59
Server02     c0095981-52c5-4e7f-a5bb-c4c680541710

Exempel 4: Hämta alla CIM-sessioner som har specifika namn

Det här exemplet hämtar alla CIM-sessioner som har namn som börjar med 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

Exempel 5: Hämta en specifik CIM-session

Det här exemplet hämtar CIM-sessionen som har ett ID på 2.

Get-CimSession -ID 2

Id           : 2
Name         : CimSession2
InstanceId   : c0095981-52c5-4e7f-a5bb-c4c680541710
ComputerName : Server02
Protocol     : WSMAN

Parametrar

-ComputerName

Anger namnet på datorn som CIM-sessioner ska anslutas till. Jokertecken tillåts.

Typ:String[]
Alias:CN, ServerName
Position:0
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:True

-Id

Anger identifieraren för CIM-sessionen som ska hämtas. För flera ID:er använder du kommatecken för att separera ID:erna eller använder intervalloperatorn (..) för att ange ett intervall med ID:er. Ett ID är ett heltal som unikt identifierar CIM-sessionen i den aktuella PowerShell-sessionen.

Mer information om intervalloperatorn finns i about_Operators.

Typ:UInt32[]
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-InstanceId

Anger instans-ID:t för CIM-sessionen som ska hämtas.

InstanceId är en globalt unik identifierare (GUID) som unikt identifierar en CIM-session. InstanceId är unikt, även om du har flera sessioner som körs i PowerShell.

InstanceId lagras i egenskapen InstanceId för objektet som representerar en CIM-session.

Typ:Guid[]
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Name

Hämtar en eller flera CIM-sessioner som innehåller de angivna egna namnen. Jokertecken tillåts.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:True

Indata

None

Du kan inte skicka objekt till den här cmdleten.

Utdata

CimSession

Den här cmdleten returnerar ett CIM-sessionsobjekt.

Kommentarer

PowerShell innehåller följande alias för Get-CimSession:

  • Windows:
    • gcms

Den här cmdleten är endast tillgänglig på Windows-plattformar.