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
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 |
|
| IDL |
|
| Bibliothèque |
|
| DLL |
|