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 |
|
| IDL |
|
| Biblioteca |
|
| DLL |
|