Partager via

Get-CimSession

  • Référence
Module:
CimCmdlets

Obtient les objets de session CIM de la session active.

Syntaxe

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

Description

L’applet de commande Get-CimSession obtient les objets de session CIM créés dans la session PowerShell actuelle.

Si elle est utilisée sans paramètre, l’applet de commande obtient toutes les sessions CIM créées dans la session PowerShell actuelle. Vous pouvez utiliser les paramètres de Get-CimSession pour obtenir les sessions destinées à des ordinateurs particuliers, ou identifier les sessions par leurs noms, ID ou ID d’instance.

Pour plus d’informations sur les sessions PowerShell, consultez about_CimSession.

Exemples

Exemple 1 : Obtenir des sessions CIM à partir de la session PowerShell actuelle

Par défaut, Get-CimSession obtient uniquement des informations sur les sessions CIM qui existent dans la session PowerShell actuelle. Get-CimSession n’obtient pas de sessions CIM créées dans d’autres sessions PowerShell ou créées sur d’autres ordinateurs.

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

Cette commande crée d’abord des sessions CIM à l’aide de New-CimSession, puis obtient les sessions CIM à l’aide de Get-CimSession.

Exemple 2 : Obtenir les sessions CIM sur un ordinateur spécifique

Get-CimSession -ComputerName Server02

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

Cette commande obtient les sessions CIM connectées à l’ordinateur nommé Server02.

Exemple 3 : Obtenir une liste de sessions CIM, puis mettre en forme la liste

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

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

Cette commande obtient toutes les sessions CIM de la session PowerShell active, puis met en forme la liste dans une table contenant uniquement les propriétés ComputerName et InstanceID.

Exemple 4 : Obtenir toutes les sessions CIM qui ont des noms spécifiques

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

Cette commande obtient toutes les sessions CIM qui ont des noms qui commencent par le serv de caractères.

Exemple 5 : Obtenir une session CIM spécifique

Get-CimSession -ID 2

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

Cette commande obtient la session CIM qui a un ID de 2.

Paramètres

-ComputerName

Spécifie le nom de l’ordinateur pour connecter les sessions CIM. Les caractères génériques sont autorisés.

Type:String[]
Alias:CN, ServerName
Position:0
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:True

-Id

Spécifie l’identificateur (ID) de la session CIM à obtenir. Pour un ou plusieurs ID, utilisez des virgules pour séparer les ID, ou utilisez l’opérateur de plage (..) pour spécifier une plage d’ID.

Un ID est un entier qui identifie de manière unique la session CIM dans la session PowerShell actuelle. Il est plus facile de mémoriser et de taper que InstanceId, mais il est unique uniquement dans la session PowerShell actuelle.

Pour plus d’informations sur l’opérateur de plage, consultez about_Operators.

Type:UInt32[]
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-InstanceId

Spécifie les ID d’instance de la session CIM à obtenir.

InstanceId est un GUID qui identifie de manière unique une session CIM. InstanceId est unique, même lorsque vous avez plusieurs sessions en cours d’exécution dans PowerShell.

InstanceId est stocké dans la propriété InstanceId de l’objet qui représente une session CIM.

Type:Guid[]
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Name

Obtient une ou plusieurs sessions CIM qui contiennent les noms conviviaux spécifiés. Les caractères génériques sont autorisés.

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:True

Entrées

None

Sorties

CimSession