Partager via


ConnectionOptions (objet)

L’objet ConnectionOptions est transmis à 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 a ces types de membres :

Propriétés

L’objet ConnectionOptions a ces propriétés.

Propriété Type d’accès Descriptif
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.

Remarques

L’objet ConnectionOptions correspond à l’interface IWSManConnectionOptions .

Si une application cliente de gestion à distance Windows s’exécute sous emprunt d’identité, une défaillance se produit si vous définissez la propriété Password . Une application cliente est un script ou un autre programme qui envoie une demande à WinRM sur l’ordinateur local ou distant. L’application cliente peut s’exécuter sous emprunt d’identité, car elle a appelé une fonction comme ImpersonateClient. Une page ou un service Active Server (ASP) 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 du nom d’utilisateur et du mot de passe 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 . Remarque : ne stockez pas les informations d’identification dans du texte brut dans les fichiers de script.

Set objWsman = CreateObject( "Wsman.Automation" )
'Create ConnectionOptions object.
Set objConnectionOptions = objWsman.CreateConnectionOptions
objConnectionOptions.UserName = "<username>"
objConnectionOptions.Password = "<password>"
iFlags = objWsman.SessionFlagUseBasic Or _
  objWsman.SessionFlagCredUserNamePassword
Set objSession = objWsman.CreateSession _
  ("https://172.30.168.2", iFlags, objConnectionOptions)
strResource = objSession.Get("winrm/config")

Spécifications

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

Voir aussi

Authentification pour les connexions à distance

api de script WinRM

à propos des de gestion à distance Windows

à l’aide du de gestion à distance Windows

Script dans windows Remote Management

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

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