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

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é pour la connexion, l’ID de session et l’ID d’instance.

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

New-CimSession

Cette commande 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.

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

New-CimSession -ComputerName Server01

Cette commande crée une session CIM sur l’ordinateur spécifié par ComputerName. Par défaut, New-CimSession crée une session WsMan quand ComputerName est spécifié.

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

New-CimSession -ComputerName Server01,Server02,Server03

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

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

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

New-CimSession -ComputerName Server01,Server02 -Name FileServers

Get-CimSession -Name File*

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

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

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

Cette commande crée une session CIM sur l’ordinateur spécifié par ComputerName, à l’aide de l’objet PSCredential spécifié par Credential, et du type d’authentification spécifié par Authentication.

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

New-CimSession -ComputerName Server01 -Port 1234

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

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

$SessionOption = New-CimSessionOption -Protocol DCOM

New-CimSession -ComputerName Server1 -SessionOption $SessionOption

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

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.

Attention : l’authentification CredSSP (Credential Security Service Provider), dans laquelle les informations d’identification de l’utilisateur sont transmises à un ordinateur distant à authentifier, 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
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 sur l’utilisation du fournisseur de certificats PowerShell, tapez Get-Help Certificateou consultez fournisseur de certificats.

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.

Vous pouvez également passer un nom d’ordinateur (entre guillemets) à New-CimSession à l’aide du pipeline.

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. 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 pour 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 si vous souhaitez 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

Cette applet de commande n’accepte aucune entrée.

Sorties

CimSession