Прочитать на английском

Поделиться через


Удаленное управление Windows

Обзор технологии удаленного управления Windows.

Для разработки удаленного управления Windows вам потребуются следующие заголовки:

Рекомендации по программированию для этой технологии см. в следующих разделах:

Перечисления

 
WSManAuthenticationFlags

Определяет метод проверки подлинности для операции.
WSManCallbackFlags

Определяет набор флагов, используемых всеми функциями обратного вызова.
WSManDataType

Указывает текущий тип данных объединения в структуре WSMAN_DATA.
WSManProxyAccessType

Определяет тип доступа прокси-сервера.
WSManProxyAccessTypeFlags

Определяет флаги типов доступа прокси-сервера.
WSManProxyAuthenticationFlags

Определяет механизм проверки подлинности прокси-сервера.
WSManSessionOption

Определяет набор расширенных параметров для сеанса. Эти параметры используются с методом WSManSetSessionOption.

Функции

 
AddOption

Добавляет данные, необходимые для обработки запроса. Например, некоторым поставщикам WMI может потребоваться объект IWbemContext или SWbemNamedValueSet со сведениями о поставщике.
AddSelector

Добавляет селектор в объект ResourceLocator. Селектор указывает конкретный экземпляр ресурса.
ClearOptions

Удаляет все параметры из объекта ResourceLocator.
ClearSelectors

Удаляет все селекторы из объекта ResourceLocator. Вы можете указать объект ResourceLocator вместо указания URI ресурса в операциях объектов IWSManSession, таких как Get, Put или Enumerate.
Создание

Создает новый экземпляр ресурса и возвращает ссылку на конечную точку (EPR) нового объекта.
CreateConnectionOptions

Создает объект IWSManConnectionOptions, указывающий имя пользователя и пароль, используемые при создании сеанса.
CreateResourceLocator

Создает объект ResourceLocator, который можно использовать вместо URI ресурса в операциях с объектами сеанса, таких как IWSManSession.Get, IWSManSession.Put или Session.Enumerate.
CreateSession

Создает объект Session, который затем можно использовать для последующих сетевых операций.
Удалить

Удаляет ресурс, указанный в URI ресурса.
Перечислить

Перечисляет таблицу, коллекцию данных или ресурс журнала.
EnumerationFlagHierarchyDeep

Возвращает значение константы перечисления EnumerationFlagHierarchyDeep для использования в параметре flags метода IWSManSession::Enumerate.
EnumerationFlagHierarchyDeepBasePropsOnly

Возвращает значение константы перечисления EnumerationFlagHierarchyDeepBasePropsOnly для использования в параметре flags метода IWSManSession::Enumerate.
EnumerationFlagHierarchyShallow

Возвращает значение константы перечисления EnumerationFlagHierarchyShallow для использования в параметре flags метода IWSManSession::Enumerate.
EnumerationFlagNonXmlText

Возвращает значение константы перечисления WSManFlagNonXmlText для использования в параметре flags метода IWSManSession::Enumerate.
EnumerationFlagReturnEPR

Возвращает значение константы перечисления EnumerationFlagReturnEPR для использования в параметре flags метода IWSManSession::Enumerate.
EnumerationFlagReturnObject

Возвращает значение константы перечисления EnumerationFlagReturnObject для использования в параметре flags метода IWSManSession::Enumerate.
EnumerationFlagReturnObjectAndEPR

Возвращает значение константы перечисления EnumerationFlagReturnObjectAndEPR для использования в параметре flags метода IWSManSession::Enumerate.
Get

Извлекает ресурс, указанный в URI, и возвращает XML-представление текущего экземпляра ресурса.
get_AtEndOfStream

Указывает, что конец элементов в объекте IWSManEnumerator был достигнут путем вызовов IWSManEnumerator::ReadItem.
get_BatchItems

Задает и получает количество элементов в каждом пакете перечисления. (Получить)
get_CertificateThumbprint

Задает или получает отпечаток сертификата, используемый при проверке подлинности с помощью проверки подлинности на основе сертификата клиента. (Получить)
get_CommandLine

Возвращает командную строку процесса, загружающего компонент автоматизации.
get_Error

Возвращает дополнительные сведения об ошибке в потоке XML для предыдущего вызова метода IWSMan, если службе удаленного управления Windows не удалось создать объект IWSManSession, объект IWSManConnectionOptions или объект IWSManResourceLocator.
get_Error

Возвращает XML-представление дополнительных сведений об ошибке. (IWSManEnumerator.get_Error)
get_Error

Возвращает XML-представление дополнительных сведений об ошибке. (IWSManResourceLocator.get_Error)
get_Error

Возвращает дополнительные сведения об ошибке в потоке XML для предыдущего вызова метода объекта IWSManSession.
get_FragmentDialect

Возвращает или задает диалект языка для диалекта фрагмента ресурса, если IWSManResourceLocator используется в методах объекта IWSManSession, таких как Get, Put или Enumerate. (Получить)
get_FragmentPath

Возвращает или задает путь к фрагменту ресурса или свойству, если ResourceLocator используется в методах объектов IWSManSession, таких как Get, Put или Enumerate. (Получить)
get_MustUnderstandOptions

Возвращает или задает значение MustUnderstandOptions для объекта ResourceLocator. (Получить)
get_ResourceURI

Универсальный код ресурса (URI) запрошенного ресурса. Это свойство может содержать только путь, а не строку запроса для конкретных экземпляров. (Получить)
get_Timeout

Задает и получает максимальное время (в миллисекундах), в течение которого клиентское приложение ожидает завершения операций удаленного управления Windows. (Получить)
get_UserName

Задает и получает имя пользователя локальной учетной записи или учетной записи домена на удаленном компьютере. Это свойство определяет имя пользователя для проверки подлинности. (Получить)
GetErrorMessage

Возвращает форматированную строку, содержащую текст номера ошибки.
Identify

Запрашивает удаленный компьютер, чтобы определить, поддерживает ли он протокол WS-Management.
Invoke

Вызывает метод и возвращает результаты вызова метода.
ProxyAuthenticationUseBasic

Возвращает значение флага проверки подлинности прокси-сервера WSManFlagProxyAuthenticationUseBasic для использования в параметре authenticationMechanism метода IWSManConnectionOptionsEx2::SetProxy.
ProxyAuthenticationUseDigest

Возвращает значение флага проверки подлинности прокси-сервера WSManFlagProxyAuthenticationUseDigest для использования в параметре authenticationMechanism метода IWSManConnectionOptionsEx2::SetProxy.
ProxyAuthenticationUseNegotiate

Возвращает значение флага проверки подлинности прокси-сервера WSManFlagProxyAuthenticationUseNegotiate для использования в параметре authenticationMechanism метода IWSManConnectionOptionsEx2::SetProxy.
ProxyAutoDetect

Возвращает значение флага типа доступа прокси-сервера WSManProxyAutoDetect для использования в параметре accessType метода IWSManConnectionOptionsEx2::SetProxy.
ProxyIEConfig

Возвращает значение флага типа доступа прокси-сервера WSManProxyIEConfig для использования в параметре accessType метода IWSManConnectionOptionsEx2::SetProxy.
ProxyNoProxyServer

Возвращает значение флага типа доступа прокси-сервера WSManProxyNoProxyServer для использования в параметре accessType метода IWSManConnectionOptionsEx2::SetProxy.
ProxyWinHttpConfig

Возвращает значение флага типа доступа прокси-сервера WSManProxyWinHttpConfig для использования в параметре accessType метода IWSManConnectionOptionsEx2::SetProxy.
Положить

Обновление ресурса.
put_BatchItems

Задает и получает количество элементов в каждом пакете перечисления. (Put)
put_CertificateThumbprint

Задает или получает отпечаток сертификата, используемый при проверке подлинности с помощью проверки подлинности на основе сертификата клиента. (Put)
put_FragmentDialect

Возвращает или задает диалект языка для диалекта фрагмента ресурса, если IWSManResourceLocator используется в методах объекта IWSManSession, таких как Get, Put или Enumerate. (Put)
put_FragmentPath

Возвращает или задает путь к фрагменту ресурса или свойству, если ResourceLocator используется в методах объектов IWSManSession, таких как Get, Put или Enumerate. (Put)
put_MustUnderstandOptions

Возвращает или задает значение MustUnderstandOptions для объекта ResourceLocator. (Put)
put_Password

Задает пароль локальной учетной записи или учетной записи домена на удаленном компьютере.
put_ResourceURI

Универсальный код ресурса (URI) запрошенного ресурса. Это свойство может содержать только путь, а не строку запроса для конкретных экземпляров. (Put)
put_Timeout

Задает и получает максимальное время (в миллисекундах), в течение которого клиентское приложение ожидает завершения операций удаленного управления Windows. (Put)
put_UserName

Задает и получает имя пользователя локальной учетной записи или учетной записи домена на удаленном компьютере. Это свойство определяет имя пользователя для проверки подлинности. (Put)
ReadItem

Извлекает элемент из ресурса и возвращает XML-представление элемента.
SessionFlagCredUsernamePassword

Возвращает значение флага проверки подлинности WSManFlagCredUsernamePassword для использования в параметре flags объекта IWSMan::CreateSession.
SessionFlagEnableSPNServerPort

Возвращает значение флага проверки подлинности WSManFlagEnableSPNServerPort для использования в параметре flags объекта IWSMan::CreateSession.
SessionFlagNoEncryption

Возвращает значение флага проверки подлинности WSManFlagNoEncryption для использования в параметре flags объекта IWSMan::CreateSession.
SessionFlagSkipCACheck

Возвращает значение флага проверки подлинности WSManFlagSkipCACheck для использования в параметре flags метода IWSMan::CreateSession.
SessionFlagSkipCNCheck

Возвращает значение флага проверки подлинности WSManFlagSkipCNCheck для использования в параметре flags объекта IWSMan::CreateSession.
SessionFlagUseBasic

Возвращает значение флага проверки подлинности WSManFlagUseBasic для использования в параметре flags объекта IWSMan::CreateSession.
SessionFlagUseClientCertificate

Возвращает значение флага проверки подлинности WSManFlagUseClientCertificate для использования в параметре flags объекта IWSMan::CreateSession.
SessionFlagUseCredSsp

Возвращает значение флага проверки подлинности WSManFlagUseCredSsp для использования в параметре flags объекта IWSMan::CreateSession.
SessionFlagUseDigest

Возвращает значение флага проверки подлинности WSManFlagUseDigest для использования в параметре flags объекта IWSMan::CreateSession.
SessionFlagUseKerberos

Возвращает значение флага проверки подлинности WSManFlagUseKerberos для использования в параметре flags объекта IWSMan::CreateSession.
SessionFlagUseNegotiate

Возвращает значение флага проверки подлинности WSManFlagUseNegotiate для использования в параметре flags объекта IWSMan::CreateSession.
SessionFlagUseNoAuthentication

Возвращает значение флага проверки подлинности WSManFlagUseNoAuthentication для использования в параметре flags объекта IWSMan::CreateSession.
SessionFlagUTF8

Возвращает значение флага проверки подлинности WSManFlagUTF8 для использования в параметре flags объекта IWSMan::CreateSession.
SetProxy

Задает сведения о прокси-сервере для сеанса.
WSMAN_PLUGIN_AUTHORIZE_OPERATION

Авторизует определенную операцию.
WSMAN_PLUGIN_AUTHORIZE_QUERY_QUOTA

Извлекает сведения о квоте для пользователя после авторизации подключения.
WSMAN_PLUGIN_AUTHORIZE_RELEASE_CONTEXT

Освобождает контекст, который передает подключаемый модуль из WSManPluginAuthzUserComplete или WSManPluginAuthzOperationComplete.
WSMAN_PLUGIN_AUTHORIZE_USER

Авторизует подключение.
WSMAN_PLUGIN_COMMAND

Определяет обратный вызов команды для подключаемого модуля.
WSMAN_PLUGIN_CONNECT

Определяет обратный вызов подключения для подключаемого модуля.
WSMAN_PLUGIN_RECEIVE

Определяет обратный вызов приема для подключаемого модуля.
WSMAN_PLUGIN_RELEASE_COMMAND_CONTEXT

Определяет обратный вызов команды выпуска для подключаемого модуля.
WSMAN_PLUGIN_RELEASE_SHELL_CONTEXT

Определяет обратный вызов оболочки выпуска для подключаемого модуля.
WSMAN_PLUGIN_SEND

Определяет обратный вызов отправки для подключаемого модуля.
WSMAN_PLUGIN_SHELL

Определяет обратный вызов оболочки для подключаемого модуля.
WSMAN_PLUGIN_SHUTDOWN

Определяет обратный вызов завершения работы для подключаемого модуля.
WSMAN_PLUGIN_SIGNAL

Определяет обратный вызов сигнала для подключаемого модуля.
WSMAN_PLUGIN_STARTUP

Определяет обратный вызов запуска для подключаемого модуля.
WSMAN_SHELL_COMPLETION_FUNCTION

Функция обратного вызова, вызываемая для операций оболочки, которые приводят к удаленному запросу.
WSManCloseCommand

Удаляет команду и освобождает связанные с ней ресурсы.
WSManCloseOperation

Отменяет или закрывает асинхронную операцию.
WSManCloseSession

Закрывает объект сеанса.
WSManCloseShell

Удаляет объект оболочки и освобождает ресурсы, связанные с оболочкой.
WSManConnectShell

Подключается к существующему сеансу сервера.
WSManConnectShellCommand

Подключается к существующей команде, выполняемой в оболочке.
WSManCreateSession

Создает объект сеанса.
WSManCreateShell

Создает объект оболочки.
WSManCreateShellEx

Создает объект оболочки, используя те же функции, что и функция WSManCreateShell, с добавлением идентификатора оболочки, указанного клиентом.
WSManDeinitialize

Отменяет инициализацию стека клиента удаленного управления Windows.
WSManDisconnectShell

Отключает сетевое подключение активной оболочки и связанных с ней команд.
WSManGetErrorMessage

Извлекает сообщения об ошибках, связанные с определенной ошибкой и кодами языков.
WSManGetSessionOptionAsDword

Возвращает значение параметра сеанса. (WSManGetSessionOptionAsDword)
WSManGetSessionOptionAsString

Возвращает значение параметра сеанса. (WSManGetSessionOptionAsString)
WSManInitialize

Инициализирует API клиента удаленного управления Windows.
WSManPluginAuthzOperationComplete

Сообщает об успешной или неудачной авторизации для операции пользователя.
WSManPluginAuthzQueryQuotaComplete

Вызывается из точки входа подключаемого модуля WSManPluginAuthzQueryQuota и должен вызываться независимо от того, может ли подключаемый модуль выполнить запрос.
WSManPluginAuthzUserComplete

Сообщает об успешной или неудачной авторизации подключения пользователя.
WSManPluginFreeRequestDetails

Освобождает память, выделенную для структуры WSMAN_PLUGIN_REQUEST, которая передается в точки входа подключаемого модуля операции.
WSManPluginGetOperationParameters

Возвращает сведения о работе для таких элементов, как время ожидания и ограничения данных, связанные с операцией.
WSManPluginOperationComplete

Сообщает о завершении операции всеми точками входа операции, за исключением методов WSManPluginStartup и WSManPluginShutdown.
WSManPluginReceiveResult

Сообщает результаты для вызова подключаемого модуля WSMAN_PLUGIN_RECEIVE и используется большинством подключаемых модулей оболочки, возвращающих результаты.
WSManPluginReportContext

Передает контекст оболочки и команд обратно в инфраструктуру удаленного управления Windows (WinRM), чтобы можно было выполнять дополнительные операции с оболочкой и/или командой.
WSManReceiveShellOutput

Извлекает выходные данные из выполняемой команды или из оболочки.
WSManReconnectShell

Повторно подключает ранее отключенный сеанс оболочки. Чтобы повторно подключить команды, связанные с сеансом оболочки, используйте WSManReconnectShellCommand.
WSManReconnectShellCommand

Повторно подключает ранее отключенную команду.
WSManRunShellCommand

Запускает выполнение команды в существующей оболочке и не ожидает завершения команды.
WSManRunShellCommandEx

Предоставляет те же функции, что и функция WSManRunShellCommand, с добавлением параметра идентификатора команды.
WSManSendShellInput

Ipes входной поток в выполняющуюся команду или в оболочку.
WSManSetSessionOption

Задает расширенный набор параметров для сеанса.
WSManSignalShell

Отправляет управляющий код в существующую команду или в саму оболочку.

Интерфейсы

 
IWSMan

Предоставляет методы и свойства, используемые для создания сеанса, представленного объектом Session.
IWSManConnectionOptions

Объект IWSManConnectionOptions передается методу IWSMan::CreateSession для предоставления имени пользователя и пароля, связанных с локальной учетной записью на удаленном компьютере.
IWSManConnectionOptionsEx

Объект IWSManConnectionOptionsEx передается методу IWSMan::CreateSession для предоставления отпечатка сертификата клиента, используемого для проверки подлинности.
IWSManConnectionOptionsEx2

Объект IWSManConnectionOptionsEx2 передается методу IWSMan::CreateSession для предоставления механизма проверки подлинности, типа доступа и учетных данных для подключения к прокси-серверу.
IWSManEnumerator

Представляет поток результатов, возвращаемых операциями, такими как операция WS-Management протокола WS-Enumeration:Enumerate.
IWSManEx

Расширяет методы и свойства интерфейса IWSMan, включая создание объектов IWSManResourceLocator, методов, возвращающих значения перечисления и флага сеанса, а также метода для получения расширенных сведений об ошибках.
IWSManEx2

Расширяет методы и свойства интерфейса IWSManEx, чтобы включить метод, возвращающий значение флага сеанса, связанное с проверкой подлинности с помощью сертификатов клиента.
IWSManEx3

Расширяет методы и свойства интерфейса IWSManEx, чтобы включить метод, возвращающий значение флага сеанса, связанное с проверкой подлинности с помощью поставщика поддержки безопасности учетных данных (CredSSP).
IWSManResourceLocator

Предоставляет путь к ресурсу. Объект IWSManResourceLocator можно использовать вместо URI ресурса в операциях объектов IWSManSession, таких как IWSManSession.Get, IWSManSession.Put или IWSManSession.Enumerate.
IWSManSession

Определяет операции и параметры сеанса.

Структуры

 
WSMAN_AUTHENTICATION_CREDENTIALS

Определяет метод проверки подлинности и учетные данные, используемые для проверки подлинности сервера или прокси-сервера.
WSMAN_AUTHZ_QUOTA

Сообщает сведения о квоте на уровне пользователя для подключаемых модулей авторизации.
WSMAN_CERTIFICATE_DETAILS

Хранит сведения о клиенте для входящего запроса, отправленного с помощью сертификата клиента.
WSMAN_COMMAND_ARG_SET

Представляет набор аргументов, передаваемых в командную строку.
WSMAN_DATA

Содержит входящие и исходящие данные, используемые в API удаленного управления Windows (WinRM).
WSMAN_DATA_BINARY

Содержит двоичные данные для использования с различными функциями удаленного управления Windows.
WSMAN_DATA_TEXT

Содержит текстовые данные для использования с различными функциями удаленного управления Windows.
WSMAN_ENVIRONMENT_VARIABLE

Определяет отдельную переменную среды с помощью пары "имя- значение".
WSMAN_ENVIRONMENT_VARIABLE_SET

Определяет массив переменных среды.
WSMAN_ERROR

Содержит сведения об ошибке, возвращаемые клиентом удаленного управления Windows (WinRM).
WSMAN_FILTER

WSMAN_FILTER зарезервировано для использования в будущем.
WSMAN_FRAGMENT

WSMAN_FRAGMENT зарезервировано для использования в будущем.
WSMAN_KEY

Представляет пару "ключ- значение" в наборе селекторов и используется для идентификации определенного ресурса.
WSMAN_OPERATION_INFO

Представляет определенную конечную точку ресурса, для которой подключаемый модуль должен выполнять запрос.
WSMAN_OPTION

Представляет определенную пару имени параметра и значения.
WSMAN_OPTION_SET

Представляет набор параметров.
WSMAN_PLUGIN_REQUEST

Указывает сведения для запроса подключаемого модуля.
WSMAN_PROXY_INFO

Указывает сведения о прокси-сервере.
WSMAN_RECEIVE_DATA_RESULT

Представляет выходные данные, полученные из метода WSManReceiveShellOutput.
WSMAN_RESPONSE_DATA

Представляет выходные данные, полученные от операции WSMan.
WSMAN_SELECTOR_SET

Определяет набор ключей, представляющих удостоверение ресурса.
WSMAN_SENDER_DETAILS

Указывает сведения о клиенте для каждого входящего запроса.
WSMAN_SHELL_ASYNC

Определяет асинхронную структуру, передаваемую всем операциям оболочки.
WSMAN_SHELL_DISCONNECT_INFO

Указывает максимальную длительность (в миллисекундах) оболочка будет оставаться открытой после отключения клиента.
WSMAN_SHELL_STARTUP_INFO_V10

Структура WSMAN_SHELL_STARTUP_INFO_V10 (wsman.h) определяет параметры запуска оболочки для использования с функцией WSManCreateShell.
WSMAN_SHELL_STARTUP_INFO_V11

Структура WSMAN_SHELL_STARTUP_INFO_V11 (wsman.h) определяет параметры запуска оболочки, которые будут использоваться с функцией WSManCreateShell.
WSMAN_STREAM_ID_SET

Перечисляет все потоки, используемые для входных или выходных данных оболочки и команд.
WSMAN_USERNAME_PASSWORD_CREDS

Определяет учетные данные, используемые для проверки подлинности.