Объект Session (WSManDisp.h)
Определяет операции и параметры сеанса. Для любых операций удаленного управления Windows требуется создать сеанс , который подключается к удаленному компьютеру, базовому контроллеру управления (BMC) или локальному компьютеру. Сетевые операции WinRM включают получение, запись или перечисление данных, а также вызов методов. Методы объекта Session зеркало базовые операции, определенные в протоколе WS-Management.
Элементы
Объект Session имеет следующие типы элементов:
Методы
Объект Session содержит следующие методы.
| Метод | Описание |
|---|---|
| Создать | Создает новый экземпляр ресурса и возвращает универсальный код ресурса (URI) нового объекта . |
| Удалить | Удаляет ресурс, указанный в URI ресурса. |
| Перечислить | Перечисляет коллекцию, таблицу или ресурс журнала сообщений. |
| Получить | Извлекает ресурс из службы и возвращает XML-представление текущего экземпляра ресурса. |
| Identify | Запрашивает удаленный компьютер, чтобы определить, поддерживает ли он протокол WS-Management |
| Invoke | Вызывает метод , возвращающий результаты вызова метода. |
| Положить | Обновление ресурса. |
Свойства
Объект Session имеет следующие свойства.
| Свойство | Тип доступа | Описание |
|---|---|---|
|
BatchItems |
Чтение/запись |
Задает и получает количество элементов в каждом пакете перечисления. Это значение нельзя изменить во время перечисления. По умолчанию используется неограниченное количество элементов. Поставщик ресурсов может задать ограничение. |
|
Ошибка |
Только для чтения |
Возвращает дополнительные сведения об ошибке в потоке XML. |
|
Времени ожидания |
Чтение/запись |
Задает и получает максимальное время ожидания клиентского приложения (в миллисекундах). |
Комментарии
Объект Session соответствует интерфейсу IWSManSession .
Примеры
В следующем примере кода VBScript показано, как создать объект Session .
' Create a WSMan object.
Dim objWsman
Set objWsman = CreateObject( "WSMAN.Automation" )
' Create Session object.
Dim objSession
Set objSession = objWsman.CreateSession
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows Vista |
| Минимальная версия сервера |
Windows Server 2008 |
| Заголовок |
|
| IDL |
|
| Библиотека |
|
| DLL |
|