WSMan Provider

-------------------------- 示例 1 --------------------------

Set-Location WSMan:

-------------------------- 示例 2 --------------------------

Set-Location -Path Localhost

-------------------------- 示例 3 --------------------------

Set-Location -Path  WSMan:\SERVER01

-------------------------- 示例 4 --------------------------

Set-Location -Path Localhost\Client

-------------------------- 示例 1 --------------------------

get-childitem -path WSMan:\Localhost

-------------------------- 示例 2 --------------------------

get-childitem -path WSMan:\SERVER01

-------------------------- 示例 3 --------------------------

get-childitem -path WSMan:\

-------------------------- 示例 4 --------------------------

Get-Childitem

指定对其创建了此侦听器的地址。其值可以为以下值之一：

-- 文本字符串“*”。（通配符 (*) 使该命令绑定所有网络接口卡 [NIC] 上的所有 IP 地址。）

-- 文本字符串“IP:”，后跟 IPv4 点分十进制格式或 IPv6 冒号十六进制格式的有效 IP 地址。

-- 文本字符串“MAC:”，后跟 NIC 的 MAC 地址。例如：MAC:32-a3-58-90-be-cc。

注意：创建侦听器时会设置地址值。

启用对远程 shell 的访问。如果将此参数设置为 False，则服务器将会拒绝新远程 shell 连接。默认值为 True。

允许客户端计算机请求未加密的通信。默认情况下，客户端计算机需要加密的网络通信。

指定参数字符串和要传递给自定义 shell 的命令行参数。此参数是可选的。

允许客户端计算机使用基本身份验证。基本身份验证是一种方案，在该方案中，用户名和密码以明文形式发送到服务器或代理服务器。此方法是最不安全的身份验证方法。

指定此统一资源标识符 (URI) 支持的操作。必须为 URI 支持的每种类型的操作创建一个条目。有效值如下：

-- Create：支持对 URI 的创建操作。如果 Create 操作支持 SupportFragment 属性这一概念，则使用该属性。SupportFiltering 属性无效，该属性应设置为 False。如果同时支持 Shell 操作，则此操作不适用于 URI。

-- Delete：支持对 URI 的删除操作。如果 Delete 操作支持 SupportFragment 属性这一概念，则使用该属性。SupportFiltering 属性无效，该属性应设置为 False。如果同时支持 Shell 操作，则此操作不适用于 URI。

-- Enumerate：支持对 URI 的枚举操作。Enumerate 操作不支持 SupportFragment 属性，该属性应设置为 False。SupportFiltering 属性有效，如果插件支持筛选，则此属性应设置为 True。如果同时支持 Shell 操作，则此操作不适用于 URI。

-- Get：支持对 URI 的 Get 操作。如果 Get 操作支持 SupportFragment 属性这一概念，则使用该属性。SupportFiltering 属性无效，该属性应设置为 False。如果同时支持 Shell 操作，则此操作不适用于 URI。

-- Invoke：支持对 URI 的调用操作。Invoke 操作不支持 SupportFragment 属性，该属性应设置为 False。SupportFiltering 属性无效，该属性应设置为 False。如果同时支持 Shell 操作，则此操作不适用于 URI。

-- Put：支持对 URI 的 Put 操作。如果 Put 操作支持 SupportFragment 属性这一概念，则使用该属性。SupportFiltering 属性无效，该属性应设置为 False。如果同时支持 Shell 操作，则此操作不适用于 URI。

-- Subscribe：支持对 URI 的订阅操作。Subscribe 操作不支持 SupportFragment 属性，该属性应设置为 False。SupportFiltering 属性无效，该属性应设置为 False。如果同时支持 Shell 操作，则此操作不适用于 URI。

-- Shell：支持对 URI 的 Shell 操作。Shell 操作不支持 SupportFragment 属性，该属性应设置为 False。SupportFiltering 属性无效，该属性应设置为 False。如果同时支持任何其他操作，则此操作不适用于 URI。如果为 URI 配置了 Shell 操作，则在 WS-Management (WinRM) 服务中对 Get、Put、Create、Delete、Invoke 和 Enumerate 操作进行内部处理，以管理 shell。因此，插件无法处理操作。

设置身份验证请求中的通道绑定令牌要求的策略。有效值如下：

-- Strict：除非存在通道绑定令牌，否则将拒绝任何请求。此设置使用通道绑定令牌，可保证所有连接都是安全的。

-- Relaxed：如果请求中存在通道绑定令牌，连接将是安全的。如果不存在通道绑定令牌，仍将接受连接。但是，连接将易于受到使用通道绑定令牌可阻止的攻击。

-- None：提供的任何通道绑定令牌都将被忽略。

此参数的值仅对 HTTPS 连接有效。

指定服务证书的证书指纹。

此值表示证书的“证书指纹”字段中的两位十六进制值字符串。它指定有权执行此操作的用户帐户的数字公钥证书 (X509)。证书用于基于客户端证书的身份验证。证书只能映射到本地用户帐户，而不适用于域帐户。若要获取证书指纹，请在 Windows PowerShell Cert: 驱动器中使用 Get-Item 或 Get-ChildItem cmdlet。

允许客户端用于证书身份验证。WS-Management 客户端将尝试查找计算机存储中的证书。如果该客户端在计算机存储中找不到证书，将尝试在当前用户存储中查找。如果未找到任何匹配的证书，用户将收到一条错误消息。

允许客户端使用凭据安全服务提供程序 (CredSSP) 身份验证。

CredSSP 身份验证允许用户委派凭据。此选项用于这样的命令：在一台远程计算机上运行，但从其他远程计算机上收集数据或者在其他远程计算机上运行其他命令。

注意：CredSSP 身份验证将本地计算机中的用户凭据委派给远程计算机。此操作增加了远程操作的安全风险。如果远程计算机的安全受到威胁，则在向该计算机传递凭据时，可使用这些凭据来控制网络会话。

指定在使用 HTTP 时客户端将使用的端口。默认情况下，HTTP 使用端口 80。您可以指定 1 到 65535 之间的任何值。

指定在使用 HTTPS 时客户端将使用的端口。默认情况下，HTTPS 使用端口 443。您可以指定 1 到 65535 之间的任何值。

允许客户端使用摘要式身份验证。摘要式身份验证是一种质询响应方案，该方案将服务器指定的数据字符串用于质询。只有客户端计算机可以发起摘要式身份验证请求。客户端计算机向服务器发送请求以进行身份验证并接收来自服务器的令牌字符串。然后，客户端计算机发送资源请求，包括用户名和与令牌字符串结合使用的加密哈希密码。HTTP 和 HTTPS 支持摘要式身份验证。WinRM Shell 客户端脚本和应用程序可以指定摘要式身份验证，但 WS-Management 服务不接受摘要式身份验证。

注意：通过 HTTP 的摘要式身份验证并不安全。

指定是启用还是禁用侦听器。默认值为 True。

指定如何使用 Sddl 参数中指定的安全设置。如果 ExactMatch 参数设置为 True，则 Sddl 中的安全设置仅用于授权严格按照 URI 指定的方式对 URI 进行访问尝试。如果 ExactMatch 设置为 False，则 Sddl 中的安全设置用于授权对 URI 进行访问尝试，这些 URI 以 URI 中指定的字符串开头。

指定用于更新 ResourceURI 和 SelectorSet 指定的管理资源的输入文件。

指定操作插件的文件名。收到请求后，将在用户上下文中展开此条目中的任何环境变量。由于每个用户可能具有不同版本的相同环境变量，因此每个用户可以具有不同的插件。此条目不能为空，必须指向有效插件。

指定运行 WS-Management (WinRM) 服务的计算机的主机名。

其值必须为完全限定的域名、IPv4 或 IPv6 文本字符串，或者为通配符。

指定当远程 shell 中没有用户活动时，远程 shell 将保持打开状态的最长时间（以毫秒为单位）。在指定的时间过后，远程 shell 将被自动删除。您可以指定 0 到 2147483647 之间的任何值。值 0 表示无限超时。默认值是 900000（15 分钟）。

指定侦听器可以使用的 IPv4 地址。有效值如下：

-- 如果保留参数为空，则不能使用 IPv4 地址。

-- 如果输入通配符 (*)，则可以使用任何 IPv4 地址。

-- 如果输入 IP 范围列表，则可以使用指定范围中的任何 IP 地址。用逗号 (,) 分隔范围，并将每个范围指定为点分十进制格式的 IPv4 地址对（以连字符 (-) 分隔）。确保较小的值先显示在地址对中。范围包含在内。

注意：IPv4 文本字符串由四个点分十进制数字组成，每个点分十进制数字都在 0 到 255 的范围内。例如：192.168.0.0。

指定侦听器可以使用的 IPv6 地址。有效值如下：

-- 如果保留参数为空，则不能使用 IPv6 地址。

-- 如果输入通配符 (*)，则可以使用任何 IPv6 地址。

-- 如果输入 IP 范围列表，则可以使用指定范围中的任何 IP 地址。用逗号 (,) 分隔范围，并将每个范围指定为冒号十六进制格式的 IPv6 地址对（以连字符 (-) 分隔）。确保较小的值先显示在地址对中。范围包含在内。

注意：IPv6 文本字符串括在括号中，且包含用冒号分隔的十六进制数字。例如：[::1] 或 [3ffe:ffff::6ECB:0101]。

指定颁发证书的证书颁发机构的名称。

允许客户端使用 Kerberos 身份验证。Kerberos 身份验证是一种方案，在该方案中，客户端和服务器使用 Kerberos 证书相互进行身份验证。

指定 IP 地址或服务实际侦听的所有 IP 地址。这些地址派生自基于与侦听器关联的实际 IP 的“地址”元素。IP 地址的值必须为 IPv4 点分十进制表示法或 IPv6 冒号分隔十六进制表示法。存在多个 ListeningOn 条目，每个条目都以 ListeningOn_ 开头。例如：

ListeningOn_1201550598

ListeningOn_1973755898

ListeningOn_1508953035

ListeningOn_1560839940

指定可以在 Pull 响应中使用的元素的最大数目。您可以指定 1 到 4294967295 之间的任何值。

指定可以在同一计算机上通过远程 shell 同时执行远程操作的最大用户数。如果用户数超过指定的限制，新 shell 连接将被拒绝。您可以指定 1 到 100 之间的任何值。

指定最大 SOAP 数据（以千字节为单位）。您可以指定 32 到 4294967295 之间的任何值。

指定活动远程 shell 及其所有子进程可以分配的最大内存总量。您可以指定 0 到 2147483647 之间的任何值。值 0 表示远程操作分配内存的能力仅受可用虚拟内存的限制。默认值为 0。

指定允许任何 shell 操作启动的最大进程数。您可以指定 0 到 2147483647 之间的任意数字。值 0 允许不限数目的进程。默认情况下，限制每个 shell 启动五个进程。

指定服务允许的并发请求的最大数目。您可以指定 1 到 4294967295 之间的任何值。限制应用于每个提供程序。

注意：此值已弃用，不应再使用。

指定任何用户可以在同一系统上远程打开的并发 shell 的最大数目。如果启用此策略设置，则在计数超过指定限制时，用户将无法打开新远程 shell。默认情况下，如果禁用此策略设置或未对其配置，将设置限制每个用户打开两个远程 shell。您可以指定 0 到 2147483647 之间的任意数字。值 0 允许不限数目的 shell。

指定可用于除 Pull 请求之外的任何请求的最大超时（以毫秒为单位）。您可以指定 500 到 4294967295 之间的任意数字。

指定 WS-Management 会话的显示名称。使用其他 cmdlet（例如 Get-PSSession 和 Enter-PSSession）时，可以使用该名称来引用会话。该名称对于计算机或当前会话来说不必是唯一的。

指定用于插件的显示名称。如果插件返回错误，则显示名称将位于返回到客户端应用程序的错误 XML 中。该名称不特定于区域设置。

允许客户端使用 Negotiate 身份验证。Negotiate 身份验证是一种方案，在该方案中，客户端将请求发送到服务器进行身份验证。服务器确定使用 Kerberos 协议还是使用 NTLM。对域帐户进行身份验证时选择 Kerberos 协议，对本地计算机帐户进行身份验证时选择 NTLM。必须以 domain\user_name 形式指定域用户的用户名。必须以 server_name\user_name 格式指定服务器计算机上的本地用户的用户名。

指定客户端计算机等待适应网络延迟时间的额外时间（以毫秒为单位）。您可以指定 500 到 4294967295 之间的任何值。

指定本地或域帐户的密码。不能为 NULL。

客户端计算机可以指定在计算机上创建 shell 时使用的凭据。必须以 domain\user_name 形式指定域用户的用户名。必须以 server_name\user_name 格式指定服务器计算机上的本地用户的用户名。

如果使用此结构，则应同时指定“用户名”和“密码”字段。该结构可以用于基本、摘要式、Negotiate 或 Kerberos 身份验证。使用基本或摘要式身份验证时，客户端必须明确指定凭据。

WS-Management 插件是本机动态链接库 (DLL)，这些链接库插入 WS-Management 并扩展其功能。WSW-Management 插件 API 提供了可使用户通过对支持的资源 URI 和操作实现某些 API 来编写插件的功能。为 WS-Management (WinRM) 服务或 Internet 信息服务 (IIS) 配置插件后，插件将分别加载到 WS-Management 主机或 IIS 主机中。远程请求将路由到这些插件入口点以执行操作。

指定对其创建了此侦听器的 TCP 端口。您可以指定 1 到 65535 之间的任何值。

指定表示不同类型的管理操作或值的终结点。服务公开了一个或多个资源，某些资源可以具有多个实例。管理资源与 WMI 类或数据库表类似，而实例与类的实例或表中的行类似。例如，Win32_LogicalDisk 类表示一个资源。Win32_LogicalDisk="C:\" 是该资源的特定实例。

统一资源标识符 (URI) 包含前缀和资源的路径。例如：

https://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk

https://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor

指定用于标识计算机上特定类型的资源（例如磁盘或进程）的统一资源标识符 (URI)。

URI 由前缀和资源的路径组成。例如：

https://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk

https://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor

指定访问控制条目的安全描述符定义语言 (SDDL)。这标识用于授权对特定资源 URI 进行访问的安全设置。

指定 WS-Management 插件 SDK 的版本。唯一有效的值是 1。

指定自定义 shell 的进程字符串。您可以指定环境变量。

指定 shell 由于处于不活动状态而超时之前的时间长度。指定超时值（以毫秒为单位）。

指定证书识别的条目。

指定插件是否支持使用在请求消息的 wsman:OptionSet 头中传递的选项。

指定用来发送和接收 WS-Management 协议请求和响应的传输协议。其值必须为 HTTP 或 HTTPS。

注意：创建侦听器时会设置 Transport 值。

通过受信任的网络连接连接到本地计算机的远程计算机的列表。如果使用不允许客户端对服务进行身份验证的身份验证方案和传输（例如，通过 HTTP 的基本身份验证），则允许将请求发送到此列表中指定的计算机。

如果在 TrustedHosts 中指定了服务器，则客户端不验证服务器的身份，从而使服务器易于受到中间人攻击。如果网络连接非常安全而不会受到恶意用户的攻击（例如在域环境中），应仅指定主机名。

指定的主机名可以为域名系统 (DNS) 名称或 IP 地址。有效值如下：

-- 空白：不信任任何主机。

-- 星号“*”字符：信任所有主机。

由逗号 (,) 分隔的主机名称模式列表。必须按照下面所示设置主机名称模式的格式：

-- 以通配符 (*) 开头的字符串。字符串必须至少包含两个字符。共享该后缀的所有主机都得到信任。

-- 以通配符 (*) 结束的字符串。字符串必须至少包含两个字符。共享该前缀的所有主机都得到信任。

-- 信任所有 NetBIOS 名称（例如，不包含句点的字符串）。

-- 没有通配符 (*) 的字符串：信任由该字符串命名的主机。

注意：TrustedHosts 值是使用 Set-Item cmdlet 设置的，Set-Item cmdlet 支持附加参数 –Concatenate。以下示例将新值 (*.domain2.com) 追加到 TrustedHost 中存储的旧值：

Set-Item .\TrustedHosts *.domain2.com -Concatenate -Force

标识基于 Sddl 参数的值授权对其访问的 URI。

接受 HTTP 或 HTTPS 请求的 URL 前缀。这是一个仅包含字符 a-z、A-Z、9-0、下划线 (_) 和正斜杠 (/) 的字符串。字符串不得以正斜杠 (/) 开头或结束。例如，如果计算机名称为 SampleComputer，WS-Management 客户端将在目标地址中指定 http://SampleMachine/URLPrefix。

指定本地帐户或域帐户的用户名。其值不能为 NULL。

客户端可以指定在计算机上创建 shell 时使用的凭据。必须以 domain\user_name 格式指定域帐户的用户名。必须以 server_name\user_name 格式指定服务器计算机上的本地帐户的用户名。

如果使用此结构，则必须同时指定“用户名”和“密码”字段。该结构可以用于基本、摘要式、Negotiate 或 Kerberos 身份验证。使用基本或摘要式身份验证时，客户端必须明确指定凭据。

指定初始化参数的值，该值是用于指定配置选项的特定于插件的值。

指定通过 WSMAN_DATA 对象将 XML 传递给插件的格式。有效值如下：

Text：传入 XML 数据包含在 WSMAN_DATA_TYPE_TEXT 结构中，该结构将 XML 表示为 PCWSTR 内存缓冲区。

XMLReader：传入 XML 数据包含在 WSMAN_DATA_TYPE_WS_XML_READER 结构中，该结构将 XML 表示为 XmlReader 对象（该对象在 WebServices.h 头文件中定义）。

一个用于指定唯一标识命名空间的统一资源名称 (URN) 的字符串。

一个用于指定语言或语言-区域（语言和区域用连字符分隔）的字符串。

指定在使用 HTTP 时客户端将使用的端口。默认情况下，HTTP 使用端口 80。您可以指定 1 到 65535 之间的任何值。

指定在使用 HTTPS 时客户端将使用的端口。默认情况下，HTTPS 使用端口 443。您可以指定 1 到 65535 之间的任何值。

注意：此值已弃用，不再可以使用。

注意：此值已弃用，不再可以使用。