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 com 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 sendo executado sob representação, ocorrerá uma falha se você definir a propriedade Senha . Um aplicativo cliente é um script ou outro programa que envia uma solicitação para o WinRM no computador local ou remoto. O aplicativo cliente pode estar sendo executado sob representação porque chamou uma função como ImpersonateClient. Um Ative Server Page (ASP) ou serviço não pode solicitar um nome de usuário e senha se o processo ASP é executado em uma conta que representa um cliente.

O sinalizador WSManFlagCredUserNamePassword deve ser definido na chamada WSman.CreateSession ao usar o UserName e Password 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 . Nota: Não armazene credenciais em texto simples 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")

Requerimentos

Ver 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 de Gerenciamento Remoto do Windows

Obtenção de dados do computador local

Obtendo dados de um computador remoto