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 ejecuta 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 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