Objeto Session (WSManDisp.h)

Define as operações e as configurações de sessão. Todas as operações de Gerenciamento Remoto do Windows exigem a criação de uma Sessão que se conecta a um computador remoto, ao controlador de gerenciamento base (BMC) ou ao computador local. As operações de rede do WinRM incluem obter, gravar ou enumerar dados ou invocar métodos. Os métodos do objeto Session espelho as operações básicas definidas no protocolo WS-Management.

Membros

O objeto Session tem estes tipos de membros:

• Métodos
• Propriedades

Métodos

O objeto Session tem estes métodos.

Método	Descrição
Criar	Cria uma nova instância de um recurso e retorna o URI do novo objeto.
Excluir	Exclui o recurso especificado no URI do recurso.
Enumerar	Enumera um recurso de coleção, tabela ou log de mensagens.
Obter	Recupera um recurso do serviço e retorna uma representação XML da instância atual do recurso.
Identificar	Consulta um computador remoto para determinar se ele dá suporte ao protocolo WS-Management
Invoke	Invoca um método que retorna os resultados da chamada de método.
Colocar	Atualiza um recurso.

Propriedades

O objeto Session tem estas propriedades.

Propriedade	Tipo de acesso	Descrição
BatchItems	Leitura/gravação	Define e obtém o número de itens em cada lote de enumeração. Esse valor não pode ser alterado durante uma enumeração. Por padrão, o padrão é um número ilimitado de itens. O provedor de recursos pode definir um limite.
Erro do	Somente leitura	Obtém informações de erro adicionais em um fluxo XML.
Tempo limite	Leitura/gravação	Define e obtém a quantidade máxima de tempo (em milissegundos) para o aplicativo cliente aguardar.

Comentários

O objeto Session corresponde à interface IWSManSession .

Exemplos

O exemplo de código VBScript a seguir mostra como criar um objeto Session .

' Create a WSMan object.
Dim objWsman 
Set objWsman = CreateObject( "WSMAN.Automation" )

' Create Session object.
Dim objSession
Set objSession = objWsman.CreateSession

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

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