Méthode WSMan. CreateSession

Crée un objet de session qui peut ensuite être utilisé pour les opérations réseau ultérieures.

Syntaxe

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

Paramètres

connexion [ dans, 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 la section Notes. Si aucune information de connexion n’est fournie, l’ordinateur local est utilisé.

indicateurs [ dans, facultatif]

Indicateurs de session qui spécifient la méthode d’authentification, telle que Negotiate Authentication ou Digest Authentication, 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 à distance. Pour plus d’informations, consultez sessions, constantes. 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 [ dans, 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 de session qui peut ensuite être utilisé pour effectuer des opérations WinRM locales ou distantes.

Remarques

La méthode CreateSession Initialise l’objet de session en rassemblant 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 de session , telle qu’une opération d' extraction ou d' énumération, 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 Windows Remote Management 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 illustrent 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 le protocole HTTPs pour se connecter à l’emplacement du service Web par défaut.

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

    Utilise le protocole 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 qui est 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, telles que WSMan. SessionFlagUseBasic.

Pour exécuter ce script, sachez 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 a la valeur true et Basic défini sur true). pour plus d’informations, consultez Installation et Configuration de 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 par négociation 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) 

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows Vista
Serveur minimal pris en charge
Windows Server 2008
En-tête
WSManDisp. h
MIDL
WSManDisp. idl
Bibliothèque
WSManDisp. tlb
DLL
WSMAuto.dll

Voir aussi

WSMan

ConnectionOptions

session

Authentification des connexions à distance

Installation et Configuration de Windows Remote Management