WSMan.CreateSession, méthode

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 auquel se 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 des indicateurs dans __WSManSessionFlags pour une connexion à distance. 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.

Notes

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, un échec se produit lors de la première opération 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 un échec 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 du service web spécifique.

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

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

• « https://[E3D7:0000:0000: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 s’arrête. Le script utilise les méthodes qui retournent la constante, telles que WSMan.SessionFlagUseBasic.

Pour exécuter ce script, n’oubliez pas que vous devez configurer les paramètres de configuration par défaut pour le client et le serveur afin d’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 Installation et configuration pour Windows Remote Management.

iFlags = WSMan.SessionFlagUseBasic Or WSMan.SessionFlagCredUsernamePassword
Set Options = Wsman.CreateConnectionOptions
Options.Username = "MyUserName"
Options.Password = "MyPassword"
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\MyUserName"
Options.Password = "MyPassword"
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 de Windows Remote Management