Dela via

Get-CimSession

Modul:
CimCmdlets Module

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

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>]

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 för Get-CimSession 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 får 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-CimSessionoch hämtar sedan CIM-sessionerna med hjälp av 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 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.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:True
DontShow:False
Alias:CN, Servernamn

Parameteruppsättningar

ComputerNameSet
Position:0
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-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ända intervalloperatorn (..) för att ange ett intervall med ID:t. Ett -ID är ett heltal som unikt identifierar CIM-sessionen i den aktuella PowerShell-sessionen.

För mer information om intervalloperatorn, se about_Operators.

Parameteregenskaper

Typ:

UInt32[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SessionIdSet
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument: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 unik, även om du har flera sessioner som körs i PowerShell.

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

Parameteregenskaper

Typ:

Guid[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

InstanceIdSet
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Name

Hämtar en eller flera CIM-sessioner som innehåller de specificerade vänliga namnen. Jokertecken tillåts.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:True
DontShow:False

Parameteruppsättningar

NameSet
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

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.