Partager via

New-CimSession

  • Référence
Module:
CimCmdlets

Crée une session CIM.

Syntaxe

New-CimSession
   [-Authentication <PasswordAuthenticationMechanism>]
   [[-Credential] <PSCredential>]
   [[-ComputerName] <String[]>]
   [-Name <String>]
   [-OperationTimeoutSec <UInt32>]
   [-SkipTestConnection]
   [-Port <UInt32>]
   [-SessionOption <CimSessionOptions>]
   [<CommonParameters>]
New-CimSession
   [-CertificateThumbprint <String>]
   [[-ComputerName] <String[]>]
   [-Name <String>]
   [-OperationTimeoutSec <UInt32>]
   [-SkipTestConnection]
   [-Port <UInt32>]
   [-SessionOption <CimSessionOptions>]
   [<CommonParameters>]

Description

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

L’applet de commande New-CimSession crée une session CIM. Une session CIM est un objet côté client représentant une connexion à un ordinateur local ou un ordinateur distant. La session CIM contient des informations sur la connexion, telles que ComputerName, le protocole utilisé ou divers identificateurs.

Cette applet de commande retourne un objet de session CIM qui peut être utilisé par toutes les autres applets de commande CIM.

Exemples

Exemple 1 : Créer une session CIM avec des options par défaut

Cet exemple crée une session CIM locale avec des options par défaut. Si ComputerName n’est pas spécifié, New-CimSession crée une session DCOM sur l’ordinateur local.

New-CimSession

Exemple 2 : Créer une session CIM sur un ordinateur spécifique

Cet exemple crée une session CIM sur l’ordinateur spécifié par ComputerName. Par défaut, New-CimSession crée une session WSMan quand nom_ordinateur est spécifié.

New-CimSession -ComputerName Server01

Exemple 3 : Créer une session CIM sur plusieurs ordinateurs

Cet exemple crée une session CIM sur chacun des ordinateurs spécifiés par ComputerName, dans la liste séparée par des virgules.

New-CimSession -ComputerName Server01, Server02, Server03

Exemple 4 : Créer une session CIM avec un nom convivial

Cet exemple crée une session CIM distante sur chacun des ordinateurs spécifiés par ComputerName, dans la liste séparée par des virgules et attribue un nom convivial aux nouvelles sessions, en spécifiant Nom.

New-CimSession -ComputerName Server01,Server02 -Name FileServers
Get-CimSession -Name File*

Vous pouvez utiliser le nom convivial d’une session CIM pour faire référence à la session dans d’autres applets de commande CIM, par exemple Get-CimSession.

Exemple 5 : Créer une session CIM sur un ordinateur à l’aide d’un objet PSCredential

Cet exemple crée une session CIM sur l’ordinateur spécifié par ComputerName, à l’aide de l’objet PSCredential spécifié par Credentialet le type d’authentification spécifié par Authentication.

New-CimSession -ComputerName Server01 -Credential $cred -Authentication Negotiate

Vous pouvez créer un objet PSCredential à l’aide de l’applet de commande Get-Credential.

Exemple 6 : Créer une session CIM sur un ordinateur à l’aide d’un port spécifique

Cet exemple crée une session CIM sur l’ordinateur spécifié par ComputerName à l’aide du port TCP spécifié par port.

New-CimSession -ComputerName Server01 -Port 1234

Exemple 7 : Créer une session CIM à l’aide de DCOM

Cet exemple crée une session CIM à l’aide du protocole COM distribué (DCOM) au lieu de WSMan.

$SessionOption = New-CimSessionOption -Protocol DCOM
New-CimSession -ComputerName Server1 -SessionOption $SessionOption

Paramètres

-Authentication

Spécifie le type d’authentification utilisé pour les informations d’identification de l’utilisateur. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Faire défaut
  • Digérer
  • Négocier
  • Basique
  • Kerberos
  • NtlmDomain
  • CredSsp

Vous ne pouvez pas utiliser le type d’authentification NtlmDomain pour la connexion à l’ordinateur local. l’authentification credSSP est disponible uniquement dans Windows Vista, Windows Server 2008 et versions ultérieures de Windows.

Prudence

L’authentification CredSSP (Credential Security Service Provider) est conçue pour les commandes qui nécessitent une authentification sur plusieurs ressources, telles que l’accès à un partage réseau distant. Ce mécanisme augmente le risque de sécurité de l’opération à distance. Si l’ordinateur distant est compromis, les informations d’identification qui lui sont transmises peuvent être utilisées pour contrôler la session réseau.

Type:PasswordAuthenticationMechanism
Valeurs acceptées:Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-CertificateThumbprint

Spécifie le certificat de clé publique numérique (X.509) d’un compte d’utilisateur autorisé à effectuer cette action. Entrez l’empreinte numérique du certificat.

Les certificats sont utilisés dans l’authentification basée sur les certificats client. Ils ne peuvent être mappés qu’à des comptes d’utilisateur locaux ; ils ne fonctionnent pas avec les comptes de domaine.

Pour obtenir une empreinte numérique de certificat, utilisez les applets de commande Get-Item ou Get-ChildItem dans le fournisseur de certificats PowerShell.

Pour plus d’informations, consultez about_Certificate_Provider.

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

-ComputerName

Spécifie le nom de l’ordinateur auquel créer la session CIM. Spécifiez un nom d’ordinateur unique ou plusieurs noms d’ordinateur séparés par une virgule.

Si ComputerName n’est pas spécifié, une session CIM sur l’ordinateur local est créée. Vous pouvez spécifier la valeur du nom de l’ordinateur dans l’un des formats suivants :

  • Un ou plusieurs noms NetBIOS
  • Une ou plusieurs adresses IP
  • Un ou plusieurs noms de domaine complets.

Si l’ordinateur se trouve dans un domaine différent de celui de l’utilisateur, vous devez spécifier le nom de domaine complet.

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

-Credential

Spécifie un compte d’utilisateur autorisé à effectuer cette action. Si informations d’identification n’est pas spécifiée, le compte d’utilisateur actuel est utilisé.

Spécifiez la valeur de Informations d’identification à l’aide de l’un des formats suivants :

  • Nom d’utilisateur : « User01 »
  • Un nom de domaine et un nom d’utilisateur : « Domain01\User01 »
  • Nom d’utilisateur principal : «User@Domain.com»
  • Objet PSCredential, tel qu’un objet retourné par l’applet de commande Get-Credential.

Lorsque vous tapez un nom d’utilisateur, vous êtes invité à entrer un mot de passe.

Type:PSCredential
Position:2
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifie un nom convivial pour la session CIM.

Vous pouvez utiliser le nom pour faire référence à la session CIM lors de l’utilisation d’autres applets de commande, telles que l’applet de commande Get-CimSession Get-CimSession. Le nom n’est pas obligatoire pour être unique à l’ordinateur ou à la session active.

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

-OperationTimeoutSec

Durée pendant laquelle l’applet de commande attend une réponse du serveur.

Par défaut, la valeur de ce paramètre est 0, ce qui signifie que l’applet de commande utilise la valeur de délai d’expiration par défaut pour le serveur.

Si le paramètre OperationTimeoutSec est défini sur une valeur inférieure au délai d’attente de nouvelle tentative de connexion robuste de 3 minutes, les échecs réseau qui durent plus que la valeur du paramètre OperationTimeoutSec ne sont pas récupérables, car l’opération sur le serveur expire avant que le client ne puisse se reconnecter.

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

-Port

Spécifie le port réseau sur l’ordinateur distant utilisé pour cette connexion. Pour vous connecter à un ordinateur distant, l’ordinateur distant doit être à l’écoute sur le port utilisé par la connexion. Les ports par défaut sont 5985 (port WinRM pour HTTP) et 5986 (port WinRM pour HTTPS).

Avant d’utiliser un autre port, vous devez configurer l’écouteur WinRM sur l’ordinateur distant pour écouter sur ce port. Utilisez les commandes suivantes pour configurer l’écouteur :

winrm delete winrm/config/listener?Address=*+Transport=HTTP

winrm create winrm/config/listener?Address=*+Transport=HTTP @{Port="\<port-number>"}

N’utilisez pas le paramètre de port, sauf si vous devez. Le paramètre de port dans la commande s’applique à tous les ordinateurs ou sessions sur lesquels la commande s’exécute. Un autre paramètre de port peut empêcher l’exécution de la commande sur tous les ordinateurs.

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

-SessionOption

Définit les options avancées pour la nouvelle session CIM. Entrez le nom d’un objet CimSessionOption créé à l’aide de l’applet de commande New-CimSessionOption.

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

-SkipTestConnection

Par défaut, l’applet de commande New-CimSession établit une connexion avec un point de terminaison de WS-Management distant pour deux raisons : pour vérifier que le serveur distant écoute le numéro de port spécifié à l’aide du paramètre port et vérifier les informations d’identification du compte spécifiés. La vérification est effectuée à l’aide d’une opération de WS-Identity standard. Vous pouvez ajouter le paramètre de commutateur SkipTestConnection si le point de terminaison de WS-Management distant ne peut pas utiliser WS-Identifier ou réduire le temps de transmission des données.

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

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 New-CimSession:

  • Windows:
    • ncms

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