Méthode IWSMan::CreateSession (wsmandisp.h)

  • Article

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

Syntaxe

HRESULT CreateSession(
  [in]  BSTR      connection,
  [in]  long      flags,
  [in]  IDispatch *connectionOptions,
  [out] IDispatch **session
);

Paramètres

[in] connection

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

[in] flags

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 au service WinRM sur l’ordinateur local.

Si aucun indicateur d’authentification n’est spécifié, Kerberos est utilisé, sauf si l’une des conditions suivantes est remplie, auquel cas Negotiate est utilisé :

  • des informations d’identification explicites sont fournies et l’hôte de destination est approuvé
  • l’hôte de destination est « localhost », « 127.0.0.1 » ou « [::1] »
  • l’ordinateur client se trouve dans un groupe de travail et l’hôte de destination est approuvé
Pour plus d’informations, consultez Authentification pour les connexions à distance et le paramètre connectionOptions .

[in] connectionOptions

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

[out] session

Pointeur vers un nouvel objet IWSManSession .

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

La liste suivante contient des exemples de 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é.

Spécifications

   
Client minimal pris en charge Windows Vista
Serveur minimal pris en charge Windows Server 2008
Plateforme cible Windows
En-tête wsmandisp.h
Bibliothèque WSManDisp.tlb
DLL WSMAuto.dll

Voir aussi

IWSMan

WSMan.CreateSession