New-CimSession

Syntaxe

CredentialParameterSet (Par défaut)

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

CertificateParameterSet

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

Description

Exemples

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

New-CimSession

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

New-CimSession -ComputerName Server01

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

New-CimSession -ComputerName Server01,Server02,Server03

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

New-CimSession -ComputerName Server01,Server02 -Name FileServers

Get-CimSession -Name File*

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

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

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

New-CimSession -ComputerName Server01 -Port 1234

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

$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 :

• Par défaut
• Résumé
• Négocier
• Élémentaire
• 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.

Propriétés du paramètre

Jeux de paramètres

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

Propriétés du paramètre

Jeux de paramètres

-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 entièrement qualifiés.

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.

Propriétés du paramètre

Jeux de paramètres

-Credential

Spécifie un compte d’utilisateur autorisé à effectuer cette action. Si Credential (Informations d’identification) n’est pas spécifié, le compte 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»
• Un objet PSCredential, comme celui retourné par le cmdlet Get-Credential.

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

Propriétés du paramètre

Jeux de paramètres

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

Propriétés du paramètre

Jeux de paramètres

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

Propriétés du paramètre

Jeux de paramètres

-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 é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.

Propriétés du paramètre

Jeux de paramètres

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

Propriétés du paramètre

Jeux de paramètres

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

Propriétés du paramètre

Jeux de paramètres

CommonParameters

Entrées

None

Sorties

CimSession

Liens associés

• Get-ChildItem
• Get-Credential
• Get-Item
• Get-CimSession
• Remove-CimSession
• New-CimSessionOption
• À propos de CimSession