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