Condividi tramite

Get-CimSession

  • Riferimento
Modulo:
CimCmdlets

Ottiene gli oggetti sessione CIM dalla sessione corrente.

Sintassi

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

Descrizione

Questo cmdlet è disponibile solo nella piattaforma Windows.

Per impostazione predefinita, il cmdlet ottiene tutte le sessioni CIM create nella sessione di PowerShell corrente. È possibile usare i parametri di Get-CimSession per ottenere le sessioni per computer specifici oppure identificare le sessioni in base ai nomi o ad altri identificatori. Get-CimSession non ottiene sessioni CIM create in altre sessioni di PowerShell o create in altri computer.

Per altre informazioni sulle sessioni CIM, vedere about_CimSession.

Esempio

Esempio 1: Ottenere sessioni CIM dalla sessione di PowerShell corrente

Questo esempio crea sessioni CIM usando New-CimSession e quindi ottiene le sessioni CIM usando 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

Esempio 2: Ottenere le sessioni CIM in un computer specifico

In questo esempio vengono recuperate le sessioni CIM connesse al computer denominato Server02.

Get-CimSession -ComputerName Server02

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

Esempio 3: Ottenere un elenco di sessioni CIM e quindi formattare l'elenco

Questo esempio ottiene tutte le sessioni CIM nella sessione di PowerShell corrente e visualizza una tabella contenente solo le proprietà ComputerName e InstanceID .

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

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

Esempio 4: Ottenere tutte le sessioni CIM con nomi specifici

In questo esempio vengono ottenute tutte le sessioni CIM con nomi che iniziano con 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

Esempio 5: Ottenere una sessione CIM specifica

In questo esempio viene recuperata la sessione CIM con ID 2.

Get-CimSession -ID 2

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

Parametri

-ComputerName

Specifica il nome del computer a cui connettersi le sessioni CIM. I caratteri jolly sono consentiti.

Tipo:String[]
Alias:CN, ServerName
Posizione:0
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:True

-Id

Specifica l'identificatore della sessione CIM da ottenere. Per più ID, usare le virgole per separare gli ID o usare l'operatore di intervallo (..) per specificare un intervallo di ID. Un ID è un numero intero che identifica in modo univoco la sessione CIM all'interno della sessione di PowerShell corrente.

Per altre informazioni sull'operatore range, vedere about_Operators.

Tipo:UInt32[]
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-InstanceId

Specifica gli ID istanza della sessione CIM da ottenere.

InstanceId è un identificatore univoco globale (GUID) che identifica in modo univoco una sessione CIM. InstanceId è univoco, anche quando sono in esecuzione più sessioni in PowerShell.

InstanceId viene archiviato nella proprietà InstanceId dell'oggetto che rappresenta una sessione CIM.

Tipo:Guid[]
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Ottiene una o più sessioni CIM che contengono i nomi descrittivi specificati. I caratteri jolly sono consentiti.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:True

Input

None

Non è possibile inviare tramite pipe oggetti a questo cmdlet.

Output

CimSession

Questo cmdlet restituisce un oggetto sessione CIM.

Note

PowerShell include gli alias seguenti per Get-CimSession:

  • Windows:
    • gcms

Questo cmdlet è disponibile solo nelle piattaforme Windows.