Partager via

Get-CimSession

Module:
CimCmdlets Module

Obtient les objets de session CIM de la session en cours.

Syntaxe

ComputerNameSet (Par défaut) 

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

SessionIdSet 

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

InstanceIdSet 

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

NameSet 

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 Get-CimSession pour obtenir les sessions destinées à des ordinateurs particuliers, ou identifier les sessions par leur nom ou d’autres identificateurs. Get-CimSession n’obtient pas de sessions CIM créées dans d’autres sessions PowerShell ou 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 en utilisant New-CimSession, puis obtient les sessions CIM en utilisant 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

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 de la session PowerShell actuelle 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 récupère la session CIM dont l’Id est 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.

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:True
DontShow:False
Alias:CN, Nom du serveur

Jeux de paramètres

ComputerNameSet
Position:0
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-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 façon unique la session CIM dans la session PowerShell actuelle.

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

Propriétés du paramètre

Type:

UInt32[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

SessionIdSet
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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. L' InstanceId est unique, même lorsque vous avez plusieurs sessions en cours d’exécution dans PowerShell.

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

Propriétés du paramètre

Type:

Guid[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

InstanceIdSet
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Name

Récupère une ou plusieurs sessions CIM contenant les noms conviviaux spécifiés. Les caractères génériques sont autorisés.

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:True
DontShow:False

Jeux de paramètres

NameSet
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

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.