Compartilhar via


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

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