Méthode WSMan.CreateSession

Crée un objet Session qui peut ensuite être utilisé pour les opérations réseau suivantes.

Syntaxe

WSMan.CreateSession( _
  [ ByVal connection ], _
  [ ByVal flags ], _
  [ ByVal connectionOptions ] _
)

Paramètres

connexion [in, facultatif]

Protocole et service à connecter, y compris IPv4 ou IPv6. Le format des informations de connexion est le suivant : <suffixe>d’adresse>< de transport><. Pour obtenir des exemples, consultez Remarques. Si aucune information de connexion n’est fournie, l’ordinateur local est utilisé.

indicateurs [in, facultatif]

Indicateurs de session qui spécifient la méthode d’authentification, telle que l’authentification Negotiate ou Digest, pour la connexion à un ordinateur distant. Ces indicateurs spécifient également d’autres informations de connexion de session, telles que l’encodage ou le chiffrement. Ce paramètre doit contenir un ou plusieurs indicateurs dans __WSManSessionFlags pour une connexion distante. Pour plus d’informations, consultez Constantes de session. Aucun paramètre d’indicateur n’est requis pour une connexion à WinRM sur l’ordinateur local. La valeur par défaut est WSManFlagUseNegotiate.

Pour plus d’informations, consultez Authentification pour les connexions à distance et le paramètre connectionOptions .

connectionOptions [in, facultatif]

Pointeur vers un objet ConnectionOptions qui contient un nom d’utilisateur et un mot de passe. La valeur par défaut est NULL.

Valeur retournée

Objet Session qui peut ensuite être utilisé pour effectuer des opérations WinRM locales ou distantes.

Remarques

La méthode CreateSession initialise l’objet Session en collectant des paramètres, tels que des indicateurs, des informations d’identification et une chaîne de connexion pour le paramètre de connexion . CreateSession ne se connecte pas réellement à l’ordinateur local ou distant. Si la connexion ne peut pas être établie, une défaillance se produit lors de la première opération de session, telle qu’une opération Get ou Enumerate, après l’appel à CreateSession. Ce comportement diffère d’une connexion WMI à un espace de noms sur un ordinateur distant. Pour plus d’informations, consultez Gestion à distance windows et WMI.

L’exemple de code VBScript suivant est utilisé pour appeler cette méthode.

Set session = _
    wsman.CreateSession("<Transport><Address><Suffix>")

Les exemples suivants montrent les différents formats utilisés pour spécifier les informations de connexion dans le paramètre de connexion (lors de la création d’une session HTTPS, le < champ Adresse> doit correspondre au nom du certificat de l’ordinateur serveur, sinon une défaillance se produit) :

• "https://service" ;

  Utilise HTTPS pour se connecter à l’emplacement du service web par défaut.

• "https://service.corp.com/websvcs/wsman" ;

  Utilise HTTPS pour se connecter à l’emplacement spécifique du service web.

• « https://[E3D7:0000:000:000:51F4:9BC8 :C0A8:6420] »

  Utilise HTTPS et IPv6 avec le port par défaut.

• « https://[E3D7:0000:000:0000:51F4:9BC8 :C0A8:6420] :9999/wsman »

  Utilise HTTPS et IPv6 avec le port donné.

Exemples

L’exemple de code VBScript suivant crée une session sur l’ordinateur local.

 Set NewSession = Wsman.CreateSession   
   

L’exemple de code VBScript suivant crée une session sur un ordinateur distant identifié par une adresse IP. Le script fournit un nom d’utilisateur et un mot de passe pour un compte. Les indicateurs WSManFlagCredUserNamePassword et WSManFlagUseBasic sont combinés pour indiquer que le compte est un compte local sur l’ordinateur distant. Si la création de la session échoue, le script se termine. Le script utilise les méthodes qui retournent la constante, comme WSMan.SessionFlagUseBasic.

Pour exécuter ce script, sachez que vous devez configurer les paramètres de configuration par défaut du client et du serveur pour autoriser le trafic non chiffré et l’authentification de base (AllowUnencrypted défini sur True et De base défini sur True). Pour plus d’informations, consultez l’article Installation et configuration de Windows Remote Management.

iFlags = WSMan.SessionFlagUseBasic Or WSMan.SessionFlagCredUsernamePassword
Set Options = Wsman.CreateConnectionOptions
Options.Username = "<username>"
Options.Password = "<password>"
Set NewSession = WSMan.CreateSession("127.0.51.1", iFlags, _
    Options) 

Dans l’exemple de code VBScript suivant, le compte est un compte de domaine et l’authentification Negotiate est utilisée. Avec l’authentification Negotiate, vous devez spécifier le nom d’utilisateur en tant que computername\username ou ipaddress\username.

iFlags = WSMan.SessionFlagUseNegotiate Or WSMan.SessionFlagCredUsernamePassword
Set Options = Wsman.CreateConnectionOptions
Options.Username = "MyComputer\<username>"
Options.Password = "<password>"
Set NewSession = WSMan.CreateSession("127.0.51.1", iFlags, _
    Options) 

Spécifications

Voir aussi

WSMan

ConnectionOptions

session

Authentification pour les connexions à distance

installation et configuration pour windows Remote Management