Объект Session (WSManDisp.h)

Статья
06/12/2023

Определяет операции и параметры сеанса. Для любых операций удаленного управления Windows требуется создать сеанс , который подключается к удаленному компьютеру, базовому контроллеру управления (BMC) или локальному компьютеру. Сетевые операции WinRM включают получение, запись или перечисление данных, а также вызов методов. Методы объекта Session зеркало базовые операции, определенные в протоколе WS-Management.

Элементы

Объект Session имеет следующие типы элементов:

Методы
Свойства

Методы

Объект Session содержит следующие методы.

Метод	Описание
Создать	Создает новый экземпляр ресурса и возвращает универсальный код ресурса (URI) нового объекта .
Удалить	Удаляет ресурс, указанный в URI ресурса.
Перечислить	Перечисляет коллекцию, таблицу или ресурс журнала сообщений.
Получить	Извлекает ресурс из службы и возвращает XML-представление текущего экземпляра ресурса.
Identify	Запрашивает удаленный компьютер, чтобы определить, поддерживает ли он протокол WS-Management
Invoke	Вызывает метод , возвращающий результаты вызова метода.
Положить	Обновление ресурса.

Свойства

Объект Session имеет следующие свойства.

Свойство	Тип доступа	Описание
BatchItems	Чтение/запись	Задает и получает количество элементов в каждом пакете перечисления. Это значение нельзя изменить во время перечисления. По умолчанию используется неограниченное количество элементов. Поставщик ресурсов может задать ограничение.
Ошибка	Только для чтения	Возвращает дополнительные сведения об ошибке в потоке XML.
Времени ожидания	Чтение/запись	Задает и получает максимальное время ожидания клиентского приложения (в миллисекундах).

Примеры

В следующем примере кода 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
Заголовок	WSManDisp.h
IDL	WSManDisp.idl
Библиотека	WSManDisp.tlb
DLL	WSMAuto.dll

См. также раздел

API скриптов WinRM
Сведения об удаленном управлении Windows
Использование удаленного управления Windows
Создание скриптов в удаленном управлении Windows
Получение данных с локального компьютера
Получение данных с удаленного компьютера