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

Cette applet de commande est disponible uniquement sur la plateforme Windows.

Par défaut, l’applet de commande obtient toutes les sessions CIM créées dans la session PowerShell actuelle. Vous pouvez utiliser les paramètres de l’obtention des Get-CimSession sessions qui concernent des ordinateurs particuliers, ou identifier les sessions par leur nom ou d’autres identificateurs. Get-CimSession n’obtient pas les sessions CIM qui ont été créées dans d’autres sessions PowerShell ou qui ont été créées sur d’autres ordinateurs.

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

Exemples

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

Cet exemple crée des sessions CIM à l’aide de New-CimSession, puis obtient les sessions CIM à l’aide Get-CimSessionde .

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

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

Cet exemple obtient les sessions CIM connectées à l’ordinateur nommé Server02.

Get-CimSession -ComputerName Server02

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

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

Cet exemple obtient toutes les sessions CIM dans la session PowerShell active et affiche une table contenant uniquement les propriétés ComputerName et InstanceID .

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

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

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

Cet exemple obtient toutes les sessions CIM qui ont des noms qui commencent par 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

Exemple 5 : Obtenir une session CIM spécifique

Cet exemple obtient la session CIM qui a un ID de 2.

Get-CimSession -ID 2

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

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 de la session CIM à obtenir. Pour 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.

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 identificateur global unique (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

Vous ne pouvez pas diriger les objets vers cette applet de commande.

Sorties

CimSession

Cette applet de commande retourne un objet de session CIM.

Notes

PowerShell inclut les alias suivants pour Get-CimSession:

  • Windows :
    • gcms

Cette applet de commande est disponible uniquement sur les plateformes Windows.