Método WSMan.CreateSession

Cria um objeto Session que pode ser usado para operações de rede subsequentes.

Sintaxe

WSMan.CreateSession( _
  [ ByVal connection ], _
  [ ByVal flags ], _
  [ ByVal connectionOptions ] _
)

Parâmetros

conexão [in, opcional]

O protocolo e o serviço ao qual se conectar, incluindo IPv4 ou IPv6. O formato das informações de conexão é o seguinte: <Sufixo> deendereço>< de transporte><. Para obter exemplos, consulte Comentários. Se nenhuma informação de conexão for fornecida, o computador local será usado.

sinalizadores [in, opcional]

Os sinalizadores de sessão que especificam o método de autenticação, como a autenticação Negotiate ou a autenticação Digest, para se conectar a um computador remoto. Esses sinalizadores também especificam outras informações de conexão de sessão, como codificação ou criptografia. Esse parâmetro deve conter um ou mais sinalizadores em __WSManSessionFlags para uma conexão remota. Para obter mais informações, consulte Constantes de sessão. Nenhuma configuração de sinalizador é necessária para uma conexão com o WinRM no computador local. O padrão é WSManFlagUseNegotiate.

Para obter mais informações, consulte Autenticação para Conexões Remotas e o parâmetro connectionOptions .

connectionOptions [in, opcional]

Um ponteiro para um objeto ConnectionOptions que contém um nome de usuário e uma senha. O padrão é NULL.

Valor retornado

Um objeto Session que pode ser usado para executar operações winRM locais ou remotas.

Comentários

O método CreateSession inicializa o objeto Session coletando parâmetros, como sinalizadores, credenciais e uma cadeia de conexão para o parâmetro de conexão . CreateSession realmente não se conecta ao computador local ou remoto. Se a conexão não puder ser estabelecida, ocorrerá uma falha na primeira operação de Sessão , como Obter ou Enumerar, após a chamada para CreateSession. Esse comportamento difere de uma conexão WMI com um namespace em um computador remoto. Para obter mais informações, consulte Gerenciamento Remoto do Windows e WMI.

O exemplo de código VBScript a seguir é usado para chamar esse método.

Set session = _
    wsman.CreateSession("<Transport><Address><Suffix>")

Os exemplos a seguir mostram os diferentes formatos usados para especificar informações de conexão no parâmetro de conexão (ao criar uma sessão HTTPS, o < campo Endereço> deve corresponder ao nome do certificado do computador do servidor; caso contrário, ocorrerá uma falha):

• "https://service"

  Usa HTTPS para se conectar ao local de serviço Web padrão.

• "https://service.corp.com/websvcs/wsman"

  Usa HTTPS para se conectar ao local do serviço Web específico.

• "https://[E3D7:0000:0000:0000:51F4:9BC8:C0A8:6420]"

  Usa HTTPS e IPv6 com a porta padrão.

• "https://[E3D7:0000:0000:0000:51F4:9BC8:C0A8:6420]:99999/wsman"

  Usa HTTPS e IPv6 com a porta fornecida.

Exemplos

O exemplo de código VBScript a seguir cria uma sessão no computador local.

 Set NewSession = Wsman.CreateSession   
   

O exemplo de código VBScript a seguir cria uma sessão em um computador remoto que é identificado por um endereço IP. O script fornece um nome de usuário e uma senha para uma conta. Os sinalizadores WSManFlagCredUserNamePassword e WSManFlagUseBasic são combinados para indicar que a conta é uma conta local no computador remoto. Se a criação da sessão falhar, o script será encerrado. O script usa os métodos que retornam a constante, como WSMan.SessionFlagUseBasic.

Para executar esse script, lembre-se de que você deve definir as configurações padrão para o cliente e o servidor para permitir o tráfego não criptografado e a autenticação básica (AllowUnencrypted definido como True e Basic definido como True). Para obter mais informações, consulte Instalação e configuração do Gerenciamento Remoto do Windows.

iFlags = WSMan.SessionFlagUseBasic Or WSMan.SessionFlagCredUsernamePassword
Set Options = Wsman.CreateConnectionOptions
Options.Username = "MyUserName"
Options.Password = "MyPassword"
Set NewSession = WSMan.CreateSession("127.0.51.1", iFlags, _
    Options) 

No exemplo de código VBScript a seguir, a conta é uma conta de domínio e a autenticação Negotiate é usada. Com a autenticação Negotiate, você deve especificar o nome de usuário como computername\username ou ipaddress\username.

iFlags = WSMan.SessionFlagUseNegotiate Or WSMan.SessionFlagCredUsernamePassword
Set Options = Wsman.CreateConnectionOptions
Options.Username = "MyComputer\MyUserName"
Options.Password = "MyPassword"
Set NewSession = WSMan.CreateSession("127.0.51.1", iFlags, _
    Options) 

Requisitos

Confira também

Wsman

Connectionoptions

Session

Autenticação para Conexões Remotas

Instalação e configuração para o Gerenciamento Remoto do Windows