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 ejecuta el script se establecen en los valores predeterminados.

Miembros

El objeto ConnectionOptions tiene estos tipos de miembros:

• Propiedades

Propiedades

El objeto ConnectionOptions tiene estas propiedades.

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

Comentarios

El objeto ConnectionOptions corresponde a la interfaz IWSManConnectionOptions .

Si una aplicación cliente de administración remota de Windows se ejecuta bajo 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 se puede ejecutar bajo 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 DE 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 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 .

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")

Requisitos

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

Consulte también

Autenticación para conexiones remotas

WinRM Scripting API

Acerca de la administración remota de Windows

Uso de administración remota de Windows

Scripting en administración remota de Windows

Obtener datos del equipo local

Obtener datos de un equipo remoto