Compartilhar via


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

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