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
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Vista |
| Serveur minimal pris en charge |
Windows Server 2008 |
| En-tête |
|
| IDL |
|
| Bibliothèque |
|
| DLL |
|
Voir aussi
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour