Condividi tramite


Get-CimSession

Ottiene gli oggetti sessione CIM dalla sessione corrente.

Sintassi

ComputerNameSet (impostazione predefinita).

Get-CimSession
    [[-ComputerName] <String[]>]
    [<CommonParameters>]

SessionIdSet

Get-CimSession
    [-Id] <UInt32[]>
    [<CommonParameters>]

InstanceIdSet

Get-CimSession
    -InstanceId <Guid[]>
    [<CommonParameters>]

NameSet

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-CimSessione 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 su un computer specifico

In questo esempio si ottengono le sessioni CIM collegate al computer chiamato 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

In questo esempio vengono ottenute tutte le sessioni CIM nella sessione di PowerShell corrente e viene visualizzata una tabella contenente solo le proprietà NomeComputer 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 pari a 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 connettere le sessioni CIM. Sono consentiti caratteri jolly.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:True
DontShow:False
Alias:Cina, Nome del Server

Set di parametri

ComputerNameSet
Posizione:0
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-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 ulteriori informazioni sull'operatore di intervallo, vedere about_Operators.

Proprietà dei parametri

Tipo:

UInt32[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

SessionIdSet
Posizione:0
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-InstanceId

Specifica gli ID delle istanze della sessione CIM da recuperare.

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

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

Proprietà dei parametri

Tipo:

Guid[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

InstanceIdSet
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Name

Ottiene una o più sessioni CIM che contengono i nomi accessibili specificati. Sono consentiti caratteri jolly.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:True
DontShow:False

Set di parametri

NameSet
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

None

Gli oggetti non possono essere inviati tramite pipe 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.