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.

Observações

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 um serviço não poderá solicitar um nome de usuário e uma senha se o processo ASP for executado em uma conta que represente 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 . Observação: não armazene credenciais em texto sem formatação em arquivos 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

Consulte também

autenticação para conexões remotas

de API de Script do WinRM

sobre o Gerenciamento Remoto do Windows

usando de Gerenciamento Remoto do Windows

scripts no de Gerenciamento Remoto do Windows

Obtendo dados do computador local

Obtendo dados de um computador remoto