Windows 远程管理

Windows 远程管理技术概述。

若要开发 Windows 远程管理，需要以下标头：

• wsman.h
• wsmandisp.h

有关此技术的编程指南，请参阅：

• Windows 远程管理

枚举

WSManAuthenticationFlags 确定操作的身份验证方法。
WSManCallbackFlags 定义所有回调函数使用的一组标志。
WSManDataType 指定WSMAN_DATA结构中联合的当前数据类型。
WSManProxyAccessType 定义代理访问类型。
WSManProxyAccessTypeFlags 定义代理访问类型标志。
WSManProxyAuthenticationFlags 确定代理身份验证机制。
WSManSessionOption 定义会话的一组扩展选项。 这些选项与 WSManSetSessionOption 方法一起使用。

函数

AddOption 添加处理请求所需的数据。 例如，某些 WMI 提供程序可能需要具有提供程序特定信息的 IWbemContext 或 SWbemNamedValueSet 对象。
AddSelector 将选择器添加到 ResourceLocator 对象。 选择器指定资源的特定实例。
ClearOptions 从 ResourceLocator 对象中删除任何选项。
ClearSelectors 从 ResourceLocator 对象中删除所有选择器。 可以提供 ResourceLocator 对象，而不是在 IWSManSession 对象操作（如 Get、Put 或 Enumerate）中指定资源 URI。
创建 创建资源的新实例，并返回新 对象的终结点引用 (EPR) 。
CreateConnectionOptions 创建一个 IWSManConnectionOptions 对象，该对象指定创建会话时使用的用户名和密码。
CreateResourceLocator 创建一个 ResourceLocator 对象，该对象可在会话对象操作（如 IWSManSession.Get、IWSManSession.Put 或 Session.Enumerate）中使用，而不是资源 URI。
CreateSession 创建一个会话对象，该对象随后可用于后续网络操作。
删除 删除资源 URI 中指定的资源。
枚举 枚举表、数据收集或日志资源。
EnumerationFlagHierarchyDeep 返回枚举常量 EnumerationFlagHierarchyDeep 的值，以便在 IWSManSession：：Enumerate 方法的 flags 参数中使用。
EnumerationFlagHierarchyDeepBasePropsOnly 返回枚举常量 EnumerationFlagHierarchyDeepBasePropsOnly 的值，以便在 IWSManSession：：Enumerate 方法的 flags 参数中使用。
EnumerationFlagHierarchyShallow 返回枚举常量 EnumerationFlagHierarchyShallow 的值，以便在 IWSManSession：：Enumerate 方法的 flags 参数中使用。
EnumerationFlagNonXmlText 返回在 IWSManSession：：Enumerate 方法的 flags 参数中使用的枚举常量 WSManFlagNonXmlText 的值。
EnumerationFlagReturnEPR 返回枚举常量 EnumerationFlagReturnEPR 的值，以便在 IWSManSession：：Enumerate 方法的 flags 参数中使用。
EnumerationFlagReturnObject 返回枚举常量 EnumerationFlagReturnObject 的值，以便在 IWSManSession：：Enumerate 方法的 flags 参数中使用。
EnumerationFlagReturnObjectAndEPR 返回枚举常量 EnumerationFlagReturnObjectAndEPR 的值，以便在 IWSManSession：：Enumerate 方法的 flags 参数中使用。
Get 检索 URI 指定的资源，并返回资源的当前实例的 XML 表示形式。
get_AtEndOfStream 指示已通过调用 IWSManEnumerator：：ReadItem 到达 IWSManEnumerator 对象中项的末尾。
get_BatchItems 设置并获取每个枚举批处理中的项数。 (获取)
get_CertificateThumbprint 设置或获取使用客户端证书身份验证进行身份验证时要使用的证书指纹。 (获取)
get_CommandLine 获取加载自动化组件的进程的命令行。
get_Error 如果 Windows 远程管理服务无法创建 IWSManSession 对象、IWSManConnectionOptions 对象或 IWSManResourceLocator 对象，请在 XML 流中获取对 IWSMan 方法的前面调用的其他错误信息。
get_Error 获取其他错误信息的 XML 表示形式。 (IWSManEnumerator.get_Error)
get_Error 获取其他错误信息的 XML 表示形式。 (IWSManResourceLocator.get_Error)
get_Error 在 XML 流中获取对 IWSManSession 对象方法的前面调用的其他错误信息。
get_FragmentDialect 获取或设置在 IWSManSession 对象方法（如 Get、Put 或 Enumerate）中使用 IWSManResourceLocator 时资源片段方言的语言方言。 (获取)
get_FragmentPath 获取或设置在 IWSManSession 对象方法（如 Get、Put 或 Enumerate）中使用 ResourceLocator 时的资源片段或属性的路径。 (获取)
get_MustUnderstandOptions 获取或设置 ResourceLocator 对象的 MustUnderstandOptions 值。 (获取)
get_ResourceURI 请求的资源的资源 URI。 此属性只能包含路径，不能包含特定实例的查询字符串。 (获取)
get_Timeout 设置并获取客户端应用程序等待 Windows 远程管理完成其操作的最长时间（以毫秒为单位）。 (获取)
get_UserName 设置并获取远程计算机上的本地帐户或域帐户的用户名。 此属性确定用于身份验证的用户名。 (获取)
GetErrorMessage 返回包含错误号文本的格式化字符串。
识别 查询远程计算机以确定它是否支持 WS-Management 协议。
Invoke 调用方法并返回方法调用的结果。
ProxyAuthenticationUseBasic 返回在 IWSManConnectionOptionsEx2：：SetProxy 方法的 authenticationMechanism 参数中使用的代理身份验证标志 WSManFlagProxyAuthenticationUseBasic 的值。
ProxyAuthenticationUseDigest 返回在 IWSManConnectionOptionsEx2：：SetProxy 方法的 authenticationMechanism 参数中使用的代理身份验证标志 WSManFlagProxyAuthenticationUseDigest 的值。
ProxyAuthenticationUseNegotiate 返回在 IWSManConnectionOptionsEx2：：SetProxy 方法的 authenticationMechanism 参数中使用的代理身份验证标志 WSManFlagProxyAuthenticationUseNegotiate 的值。
ProxyAutoDetect 返回在 IWSManConnectionOptionsEx2：：SetProxy 方法的 accessType 参数中使用的代理访问类型标志 WSManProxyAutoDetect 的值。
ProxyIEConfig 返回在 IWSManConnectionOptionsEx2：：SetProxy 方法的 accessType 参数中使用的代理访问类型标志 WSManProxyIEConfig 的值。
ProxyNoProxyServer 返回在 IWSManConnectionOptionsEx2：：SetProxy 方法的 accessType 参数中使用的代理访问类型标志 WSManProxyNoProxyServer 的值。
ProxyWinHttpConfig 返回在 IWSManConnectionOptionsEx2：：SetProxy 方法的 accessType 参数中使用的代理访问类型标志 WSManProxyWinHttpConfig 的值。
把 更新资源。
put_BatchItems 设置并获取每个枚举批处理中的项数。 (放置)
put_CertificateThumbprint 设置或获取使用客户端证书身份验证进行身份验证时要使用的证书指纹。 (放置)
put_FragmentDialect 获取或设置在 IWSManSession 对象方法（如 Get、Put 或 Enumerate）中使用 IWSManResourceLocator 时资源片段方言的语言方言。 (放置)
put_FragmentPath 获取或设置在 IWSManSession 对象方法（如 Get、Put 或 Enumerate）中使用 ResourceLocator 时的资源片段或属性的路径。 (放置)
put_MustUnderstandOptions 获取或设置 ResourceLocator 对象的 MustUnderstandOptions 值。 (放置)
put_Password 在远程计算机上设置本地帐户或域帐户的密码。
put_ResourceURI 所请求资源的资源 URI。 此属性只能包含路径，而不能包含特定实例的查询字符串。 (放置)
put_Timeout 设置并获取客户端应用程序等待 Windows 远程管理完成其操作的最长时间（以毫秒为单位）。 (放置)
put_UserName 设置并获取远程计算机上的本地帐户或域帐户的用户名。 此属性确定用于身份验证的用户名。 (放置)
ReadItem 从资源中检索项并返回该项的 XML 表示形式。
SessionFlagCredUsernamePassword 返回在 IWSMan：：CreateSession 的 flags 参数中使用的身份验证标志 WSManFlagCredUsernamePassword 的值。
SessionFlagEnableSPNServerPort 返回在 IWSMan：：CreateSession 的 flags 参数中使用的身份验证标志 WSManFlagEnableSPNServerPort 的值。
SessionFlagNoEncryption 返回在 IWSMan：：CreateSession 的 flags 参数中使用的身份验证标志 WSManFlagNoEncryption 的值。
SessionFlagSkipCACheck 返回在 IWSMan：：CreateSession 方法的 flags 参数中使用的 WSManFlagSkipCACheck 身份验证标志的值。
SessionFlagSkipCNCheck 返回在 IWSMan：：CreateSession 的 flags 参数中使用的身份验证标志 WSManFlagSkipCNCheck 的值。
SessionFlagUseBasic 返回在 IWSMan：：CreateSession 的 flags 参数中使用的身份验证标志 WSManFlagUseBasic 的值。
SessionFlagUseClientCertificate 返回在 IWSMan：：CreateSession 的 flags 参数中使用的身份验证标志 WSManFlagUseClientCertificate 的值。
SessionFlagUseCredSsp 返回在 IWSMan：：CreateSession 的 flags 参数中使用的身份验证标志 WSManFlagUseCredSsp 的值。
SessionFlagUseDigest 返回在 IWSMan：：CreateSession 的 flags 参数中使用的身份验证标志 WSManFlagUseDigest 的值。
SessionFlagUseKerberos 返回在 IWSMan：：CreateSession 的 flags 参数中使用的身份验证标志 WSManFlagUseKerberos 的值。
SessionFlagUseNegotiate 返回在 IWSMan：：CreateSession 的 flags 参数中使用的身份验证标志 WSManFlagUseNegotiate 的值。
SessionFlagUseNoAuthentication 返回在 IWSMan：：CreateSession 的 flags 参数中使用的身份验证标志 WSManFlagUseNoAuthentication 的值。
SessionFlagUTF8 返回在 IWSMan：：CreateSession 的 flags 参数中使用的身份验证标志 WSManFlagUTF8 的值。
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 定义插件的发布 shell 回调。
WSMAN_PLUGIN_SEND 定义插件的发送回调。
WSMAN_PLUGIN_SHELL 定义插件的 shell 回调。
WSMAN_PLUGIN_SHUTDOWN 定义插件的关闭回调。
WSMAN_PLUGIN_SIGNAL 定义插件的信号回调。
WSMAN_PLUGIN_STARTUP 定义插件的启动回调。
WSMAN_SHELL_COMPLETION_FUNCTION 为 shell 操作调用的回调函数，这会导致远程请求。
WSManCloseCommand 删除命令并释放与其关联的资源。
WSManCloseOperation 取消或关闭异步操作。
WSManCloseSession 关闭会话对象。
WSManCloseShell 删除 shell 对象并释放与 shell 关联的资源。
WSManConnectShell 连接到现有服务器会话。
WSManConnectShellCommand 连接到在 shell 中运行的现有命令。
WSManCreateSession 创建会话对象。
WSManCreateShell 创建 shell 对象。
WSManCreateShellEx 使用与 WSManCreateShell 函数相同的功能创建 shell 对象，并添加客户端指定的 shell ID。
WSManDeinitialize 取消初始化 Windows 远程管理客户端堆栈。
WSManDisconnectShell 断开活动 shell 及其关联命令的网络连接。
WSManGetErrorMessage 检索与特定错误和语言代码关联的错误消息。
WSManGetSessionOptionAsDword 获取会话选项的值。 (WSManGetSessionOptionAsDword)
WSManGetSessionOptionAsString 获取会话选项的值。 (WSManGetSessionOptionAsString)
WSManInitialize 初始化 Windows 远程管理客户端 API。
WSManPluginAuthzOperationComplete 报告用户操作的授权成功或失败。
WSManPluginAuthzQueryQuotaComplete 从 WSManPluginAuthzQueryQuota 插件入口点调用，无论插件是否可以执行请求，都必须调用 。
WSManPluginAuthzUserComplete 报告用户连接授权成功或失败。
WSManPluginFreeRequestDetails 释放为WSMAN_PLUGIN_REQUEST结构分配的内存，该结构传递到操作插件入口点。
WSManPluginGetOperationParameters 获取与操作关联的项（例如超时和数据限制）的操作信息。
WSManPluginOperationComplete 报告除 WSManPluginStartup 和 WSManPluginShutdown 方法之外的所有操作入口点完成的操作。
WSManPluginReceiveResult 报告WSMAN_PLUGIN_RECEIVE插件调用的结果，大多数返回结果的 shell 插件都使用。
WSManPluginReportContext 将 shell 和命令上下文报告回 Windows 远程管理 (WinRM) 基础结构，以便可以针对 shell 和/或命令执行进一步操作。
WSManReceiveShellOutput 从正在运行的命令或 shell 检索输出。
WSManReconnectShell 重新连接以前断开连接的 shell 会话。 若要重新连接 shell 会话的关联命令，请使用 WSManReconnectShellCommand。
WSManReconnectShellCommand 重新连接以前断开连接的命令。
WSManRunShellCommand 在现有 shell 中启动命令的执行，并且不等待命令完成。
WSManRunShellCommandEx 提供与 WSManRunShellCommand 函数相同的功能，并添加了命令 ID 选项。
WSManSendShellInput 将输入流 Ipes 到正在运行的命令或 shell。
WSManSetSessionOption 设置会话的扩展选项集。
WSManSignalShell 将控件代码发送到现有命令或 shell 本身。

接口

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 提供资源的路径。 可以在 IWSManSession 对象操作（例如 IWSManSession.Get、IWSManSession.Put 或 IWSManSession.Enumerate）中使用 IWSManResourceLocator 对象，而不是资源 URI。
IWSManSession 定义操作和会话设置。

结构

WSMAN_AUTHENTICATION_CREDENTIALS 定义用于服务器或代理身份验证的身份验证方法和凭据。
WSMAN_AUTHZ_QUOTA 按用户报告授权插件的配额信息。
WSMAN_CERTIFICATE_DETAILS 存储使用客户端证书发送的入站请求的客户端信息。
WSMAN_COMMAND_ARG_SET 表示传递到命令行的参数集。
WSMAN_DATA 包含 Windows 远程管理 (WinRM) API 中使用的入站和出站数据。
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 定义要传递给所有 shell 操作的异步结构。
WSMAN_SHELL_DISCONNECT_INFO 指定在客户端断开连接后 shell 将保持打开状态的最长持续时间（以毫秒为单位）。
WSMAN_SHELL_STARTUP_INFO_V10 WSMAN_SHELL_STARTUP_INFO_V10 (wsman.h) 结构定义要与 WSManCreateShell 函数一起使用的 shell 启动参数。
WSMAN_SHELL_STARTUP_INFO_V11 WSMAN_SHELL_STARTUP_INFO_V11 (wsman.h) 结构定义要与 WSManCreateShell 函数一起使用的 shell 启动参数。
WSMAN_STREAM_ID_SET 列出用于 shell 和 命令的输入或输出的所有流。
WSMAN_USERNAME_PASSWORD_CREDS 定义用于身份验证的凭据。