Objeto Session (WSManDisp.h)

  • Artículo

Define las operaciones y la configuración de sesión. Todas las operaciones de administración remota de Windows requieren la creación de una sesión que se conecte a un equipo remoto, un controlador de administración base (BMC) o el equipo local. Las operaciones de red de WinRM incluyen la obtención, escritura o enumeración de datos o la invocación de métodos. Los métodos del objeto Session reflejan las operaciones básicas definidas en el protocolo WS-Management.

Miembros

El objeto Session contiene estos tipos de miembros:

Métodos

El objeto Session tiene estos métodos.

Método Descripción
Crear Crea una nueva instancia de un recurso y devuelve el URI del nuevo objeto.
Eliminar Elimina el recurso especificado en el URI del recurso.
Enumerar Enumera una colección, una tabla o un recurso de registro de mensajes.
Obtener Recupera un recurso del servicio y devuelve una representación XML de la instancia actual del recurso.
Identificar Consulta un equipo remoto para determinar si admite el protocolo WS-Management
Invocar Invoca un método que devuelve los resultados de la llamada al método .
Poner Actualiza un recurso.

Propiedades

El objeto Session tiene estas propiedades.

Propiedad Tipo de acceso Descripción
BatchItems
 Lectura/escritura
 Establece y obtiene el número de elementos de cada lote de enumeración. Este valor no se puede cambiar durante una enumeración. De forma predeterminada, el valor predeterminado es un número ilimitado de elementos. El proveedor de recursos puede establecer un límite.
Error
 Solo lectura
 Obtiene información de error adicional en una secuencia XML.
Tiempo de espera
 Lectura/escritura
 Establece y obtiene la cantidad máxima de tiempo (en milisegundos) para que la aplicación cliente espere.

Comentarios

El objeto Session corresponde a la interfaz IWSManSession .

Ejemplos

En el siguiente ejemplo de código de VBScript se muestra cómo crear un objeto Session .

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

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

Requisitos

Requisito Value
Cliente mínimo compatible
 Windows Vista
Servidor mínimo compatible
 Windows Server 2008
Encabezado
WSManDisp.h
IDL
WSManDisp.idl
Biblioteca
WSManDisp.tlb
Archivo DLL
WSMAuto.dll

Consulte también

WinRM Scripting API

Acerca de la administración remota de Windows

Uso de administración remota de Windows

Scripting en administración remota de Windows

Obtener datos del equipo local

Obtener datos de un equipo remoto