Objet ConnectionOptions

L’objet ConnectionOptions est passé à la méthode CreateSession pour fournir le nom d’utilisateur et le mot de passe associés au compte local sur l’ordinateur distant. Si aucun paramètre n’est fourni, les informations d’identification du compte exécutant le script sont définies sur les valeurs par défaut.

Membres

L’objet ConnectionOptions possède les types de membres suivants :

• Propriétés

Propriétés

L’objet ConnectionOptions possède ces propriétés.

Propriété	Type d’accès	Description
Mot de passe	Écriture seule	Définit le mot de passe d’un compte local ou de domaine sur l’ordinateur distant.
UserName	Lecture/écriture	Définit et obtient le nom d’utilisateur d’un compte local ou de domaine sur l’ordinateur distant.

Notes

L’objet ConnectionOptions correspond à l’interface IWSManConnectionOptions.

Si une application cliente De gestion à distance Windows s’exécute sous emprunt d’identité, un échec se produit si vous définissez la propriété Password . Une application cliente est un script ou un autre programme qui envoie une requête à WinRM sur l’ordinateur local ou distant. L’application cliente peut s’exécuter sous emprunt d’identité, car elle a appelé une fonction telle que ImpersonateClient. Une page ASP (Active Server Page) ou un service ne peut pas demander un nom d’utilisateur et un mot de passe si le processus ASP s’exécute sous un compte qui emprunte l’identité d’un client.

L’indicateur WSManFlagCredUserNamePassword doit être défini sur l’appel WSman.CreateSession lors de l’utilisation de UserName et Password pour l’authentification.

Exemples

L’exemple de code VBScript suivant montre comment créer un objet ConnectionOptions , définir les propriétés du compte sur l’ordinateur distant et l’utiliser pour créer un objet Session .

Set objWsman = CreateObject( "Wsman.Automation" )
'Create ConnectionOptions object.
Set objConnectionOptions = objWsman.CreateConnectionOptions
objConnectionOptions.UserName = "johns "
objConnectionOptions.Password = "Dtf#4542?98"
iFlags = objWsman.SessionFlagUseBasic Or _
  objWsman.SessionFlagCredUserNamePassword
Set objSession = objWsman.CreateSession _
  ("https://172.30.168.2", iFlags, objConnectionOptions)
strResource = objSession.Get("winrm/config")

Spécifications

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

Voir aussi

Authentification pour les connexions à distance

WinRM Scripting API

À propos de la gestion à distance Windows

Utilisation de la gestion à distance Windows

Création de scripts dans La gestion à distance Windows

Obtention de données à partir de l’ordinateur local

Obtention de données à partir d’un ordinateur distant