Compartir a través de


ConnectionOptions (objeto)

El objeto ConnectionOptions se pasa al método CreateSession para proporcionar el nombre de usuario y la contraseña asociados a la cuenta local en el equipo remoto. Si no se proporciona ningún parámetro, las credenciales de la cuenta que ejecutan el script se establecen en los valores predeterminados.

Miembros

El objeto ConnectionOptions tiene estos tipos de miembros:

Propiedades

El objeto ConnectionOptions tiene estas propiedades.

Propiedad Tipo de acceso Descripción
Contraseña
Solo escritura
Establece la contraseña de una cuenta de dominio o local en el equipo remoto.
UserName
Lectura/escritura
Establece y obtiene el nombre de usuario de una cuenta de dominio o local en el equipo remoto.

Observaciones

El objeto ConnectionOptions corresponde a la interfaz IWSManConnectionOptions .

Si una aplicación cliente de administración remota de Windows se ejecuta en suplantación, se produce un error si establece la propiedad Password . Una aplicación cliente es un script u otro programa que envía una solicitud a WinRM en el equipo local o remoto. La aplicación cliente puede ejecutarse en suplantación porque llamó a una función como ImpersonateClient. Una página de servidor activo (ASP) o un servicio no pueden solicitar un nombre de usuario y una contraseña si el proceso ASP se ejecuta en una cuenta que suplanta a un cliente.

La marca WSManFlagCredUserNamePassword debe establecerse en la llamada WSman.CreateSession al usar username y password para la autenticación.

Ejemplos

En el siguiente ejemplo de código de VBScript se muestra cómo crear un objeto ConnectionOptions , establecer las propiedades de la cuenta en el equipo remoto y usarlo para crear un objeto Session . Nota: No almacene credenciales en texto sin formato en archivos 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")

Requisitos

Requisito Importancia
Cliente mínimo compatible
Windows Vista
Servidor mínimo compatible
Windows Server 2008
Cabecera
WSManDisp.h
IDL
WSManDisp.idl
Biblioteca
WSManDisp.tlb
DLL
WSMAuto.dll

Consulte también

autenticación de para conexiones remotas

api de scripting de WinRM de

Acerca de la administración remota de Windows

usar el de administración remota de Windows

Scripting en windows Remote Management

Obtención de datos del equipo local

Obtención de datos de un equipo remoto