Objeto ConnectionOptions

O objeto ConnectionOptions é passado para o método CreateSession para fornecer o nome de usuário e a senha associados à conta local no computador remoto. Se nenhum parâmetro for fornecido, as credenciais da conta que executa o script serão definidas como os valores padrão.

Membros

O objeto ConnectionOptions tem estes tipos de membros:

• Propriedades

Propriedades

O objeto ConnectionOptions tem essas propriedades.

Propriedade	Tipo de acesso	Descrição
Senha	Somente gravação	Define a senha de uma conta local ou de domínio no computador remoto.
Username	Leitura/gravação	Define e obtém o nome de usuário de uma conta local ou de domínio no computador remoto.

Comentários

O objeto ConnectionOptions corresponde à interface IWSManConnectionOptions .

Se um aplicativo cliente de Gerenciamento Remoto do Windows estiver em execução sob representação, ocorrerá uma falha se você definir a propriedade Password . Um aplicativo cliente é um script ou outro programa que envia uma solicitação ao WinRM no computador local ou remoto. O aplicativo cliente pode estar em execução em representação porque ele chamou uma função como ImpersonateClient. Uma PÁGINA do Servidor Ativo (ASP) ou serviço não poderá solicitar um nome de usuário e uma senha se o processo ASP for executado em uma conta que representa um cliente.

O sinalizador WSManFlagCredUserNamePassword deve ser definido na chamada WSman.CreateSession ao usar o Nome de Usuário e a Senha para autenticação.

Exemplos

O exemplo de código VBScript a seguir mostra como criar um objeto ConnectionOptions , definir as propriedades da conta no computador remoto e usá-lo na criação de um 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	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Cabeçalho	WSManDisp.h
IDL	WSManDisp.idl
Biblioteca	WSManDisp.tlb
DLL	WSMAuto.dll

Confira também

Autenticação para Conexões Remotas

API de script do WinRM

Sobre o Gerenciamento Remoto do Windows

Usando o Gerenciamento Remoto do Windows

Scripts no Gerenciamento Remoto do Windows

Obtendo dados do computador local

Obtendo dados de um computador remoto