Partager via


New-CimSession

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 New-CimSession de commande 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 lorsque ComputerName 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 Le 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 Credential et du type d’authentification spécifié par l’authentification.

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

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

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 valides pour ce paramètre sont :

  • Par défaut
  • Digest
  • Negotiate
  • De base
  • 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) 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é lié à l'opération distante. Si l'ordinateur distant n'est pas fiable, les informations d'identification qui lui sont passées 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 par certificat client. Ils peuvent être mappés uniquement aux 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 ou Get-ChildItem les Get-Item applets de commande 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 qui a l’autorisation d’exécuter cette action. Si les informations d’identification ne sont pas spécifiées, le compte d’utilisateur actuel est utilisé.

Spécifiez la valeur des 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 Get-Credential commande.

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'a pas obligatoirement à être unique sur l'ordinateur ou dans 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 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 établir une connexion à 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 qu'il écoute 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 Port , sauf si vous devez. Le paramètre de port de 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 la commande de s'exécuter 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 New-CimSessionOption commande.

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 New-CimSession de commande établit une connexion avec un point de terminaison 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 WS-Identity standard. Vous pouvez ajouter le paramètre de commutateur SkipTestConnection si le point de terminaison 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.