Objeto Session (WSManDisp.h)
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 |
|
| IDL |
|
| Biblioteca |
|
| Archivo DLL |
|