about_WSMan_Provider

提供程序名称

WSMan

驱动器

WSMan:

简短说明

提供对 Web 服务管理 (WS-Management) 配置信息的访问权限。

详细说明

此信息仅适用于在 Windows 上运行的 PowerShell。

通过 PowerShell 的 WSMan 提供程序，你可以添加、更改、清除和删除本地或远程计算机上的 WS-Management 配置数据。

WSMan 提供程序公开了 PowerShell 驱动器，该驱动器具有与 WS-Management 配置设置的逻辑分组相对应的目录结构。 这些分组称为容器。

从 Windows PowerShell 3.0 开始，WSMan 提供程序已更新为支持会话配置的新属性（例如 OutputBufferingMode）。 会话配置显示为 WSMan: 驱动器的 Plugin 目录中的项，而属性显示为每个会话配置中的项。

WSMan 提供程序支持本文中介绍的以下 cmdlet。

• Get-Location
• Set-Location
• Get-Item
• Get-ChildItem
• New-Item
• Remove-Item

注意

可以使用 WSMan: 驱动器中的命令来更改新属性的值。 但是，你不能使用 PowerShell 2.0 中的 WSMan: 驱动器来更改 Windows PowerShell 3.0 中引入的属性。 尽管不会生成错误，但命令将不起作用。若要更改这些设置，请使用 Windows PowerShell 3.0 中的 WSMan 驱动器。

WSMan: 驱动器的组织

• Client：可以配置 WS-Management 客户端的各个方面。 配置信息存储在注册表中。

• Service：可以配置 WS-Management 服务的各个方面。 配置信息存储在注册表中。

  注意

  服务配置有时称为服务器配置。

• Shell：可以配置 WS-Management 外壳程序的各个方面，例如用于允许远程外壳程序访问的设置 (AllowRemoteShellAccess) 和允许的最大并发用户数 (MaxConcurrentUsers)。

• Listener：可以创建和配置侦听器。 侦听器是一项用于实现 WS-Management 协议以发送和接收消息的管理服务。

• Plugin：插件由 WS-Management 服务加载和使用，以提供各种功能。 默认情况下，PowerShell 提供三个插件：

  • Event Forwarding 插件。
  • Microsoft.PowerShell 插件。
  • Windows Management Instrumentation (WMI) 提供程序插件。 这三个插件支持事件转发、配置和 WMI 访问。

• ClientCertificate：可以创建和配置客户端证书。 当 WS-Management 客户端配置为使用证书身份验证时，将使用客户端证书。

WSMan 提供程序的目录层次结构

本地计算机的 WSMan 提供程序的目录层次结构如下所示。

WSMan:\localhost
--- Client
--- Service
--- Shell
--- Listener
------ <Specific_Listener>
--- Plugin
------ Event Forwarding Plugin
--------- InitializationParameters
--------- Resources
------------ Security
------ Microsoft.Powershell
--------- InitializationParameters
--------- Resources
------------ Security
------ WMI Provider
--------- InitializationParameters
--------- Resources
------------ Security
--- ClientCertificate

远程计算机的 WSMan 提供程序的目录层次结构与本地计算机相同。 但是，为了访问远程计算机的配置设置，你需要使用 Connect-WSMan 建立与远程计算机的连接。 建立与远程计算机的连接后，远程计算机的名称将显示在提供程序中。

WSMan:\<Remote_Computer_Name>

导航 WSMan: 驱动器

此命令使用 Set-Location cmdlet 将当前位置更改为 WSMan: 驱动器。

Set-Location WSMan:

若要返回到文件系统驱动器，请键入驱动器名称。 例如，键入。

Set-Location C:

导航到远程系统存储位置

此命令使用 Set-Location 命令将当前位置更改为远程系统存储位置中的根位置。 使用反斜杠 \ 或正斜杠 / 指示 WSMan: 驱动器的级别。

Set-Location -Path  WSMan:\SERVER01

注意

以上命令假定与远程系统的连接已存在。

显示 WSMan: 驱动器的内容

此命令使用 Get-Childitem cmdlet 显示 Localhost 存储位置中的 WS-Management 存储。

Get-ChildItem -path WSMan:\Localhost

如果你在 WSMan: 驱动器中，则可以省略驱动器名称。

此命令使用 Get-Childitem cmdlet 显示远程计算机 "SERVER01" 存储位置中的 WS-Management 存储。

Get-ChildItem -path WSMan:\SERVER01

注意

以上命令假定与远程系统的连接已存在。

设置 WSMAN: 驱动器中项的值

可以使用 Set-Item cmdlet 更改 WSMAN 驱动器中的配置设置。 以下示例将 TrustedHosts 值设置为接受后缀为“contoso.com”的所有主机。

# You do not need to specify the -Path parameter name when using Set-Item.
PS WSMAN:\localhost\Client> Set-Item .\TrustedHosts -Value "*.contoso.com"

Set-Item cmdlet 支持附加参数 -Concatenate，该参数追加值而不是更改值。 下面的示例会将一个新值“*.domain2.com”追加到存储在 TrustedHost: 中的旧值

Set-Item WSMAN:\localhost\Client\TrustedHosts *.domain2.com -Concatenate

在 WSMAN: 驱动器中创建项

创建新侦听器

New-Item cmdlet 在提供程序驱动器中创建项。 每个提供程序都有可以创建的不同项类型。 在 WSMAN: 驱动器中，可以创建侦听器，将其配置为接收和响应远程请求。 以下命令使用 New-Item cmdlet 创建新的 HTTP 侦听器。

New-Item -Path WSMan:\localhost\Listener -Address * -Transport HTTP -force

创建新的插件

此命令将为 WS-Management 服务创建（注册）插件。

New-Item -Path WSMan:\localhost\Plugin `
         -Plugin TestPlugin `
         -FileName %systemroot%\system32\WsmWmiPl.dll `
         -Resource http://schemas.dmtf.org/wbem/wscim/2/cim-schema `
         -SDKVersion 1 `
         -Capability "Get","Put","Invoke","Enumerate" `
         -XMLRenderingType text

创建新资源条目

此命令将在 TestPlugin 的 Resources 目录中创建资源条目。 此命令假定已使用单独的命令创建 TestPlugin。

New-Item -Path WSMan:\localhost\Plugin\TestPlugin\Resources `
         -ResourceUri http://schemas.dmtf.org/wbem/wscim/3/cim-schema `
         -Capability "Enumerate"

为资源创建新的安全条目

此命令将在 Resource_5967683（一种特定资源）的 Security 目录中创建一个安全条目。 此命令假定已使用单独的命令创建资源条目。

$path = "WSMan:\localhost\Plugin\TestPlugin\Resources\Resource_5967683"
New-Item -Path $path\Security `
         -Sddl "O:NSG:BAD:P(A;;GA;;;BA)S:P(AU;FA;GA;;;WD)(AU;SA;GWGX;;;WD)"

创建新的客户端证书

此命令将创建可供 WS-Management 客户端使用的 ClientCertificate 条目。 新的 ClientCertificate 将在 ClientCertificate 目录下显示为 ClientCertificate_1234567890。 所有参数都是必需的。 Issuer 需是颁发者证书的指纹。

$cred = Get-Credential
New-Item -Path WSMan:\localhost\ClientCertificate `
         -Issuer 1b3fd224d66c6413fe20d21e38b304226d192dfe `
         -URI wmicimv2/* `
         -Credential $cred;

创建新的初始化参数

此命令用于在“InitializationParameters”目录中创建名为“testparametername”的初始化参数。 此命令假定已使用单独的命令创建“TestPlugin”。

New-Item -Path WSMan:\localhost\Plugin\TestPlugin\InitializationParameters `
         -ParamName testparametername `
         -ParamValue testparametervalue

动态参数

动态参数是由 PowerShell 提供程序添加的 cmdlet 参数，且只可用于在启用了提供程序的驱动器中使用 cmdlet 的情况。

Address <字符串>

指定已为其创建此侦听器的地址。 值可以是下列任一值：

• 文本字符串 "*"。 （通配符 (*) 使该命令可绑定所有网络适配器上的所有 IP 地址。）
• 文本字符串“IP:”后跟采用 IPv4 以点分隔的十进制格式或 IPv6 以冒号分隔的十六进制格式的有效 IP 地址。
• 文本字符串“MAC:”后跟适配器的 MAC 地址。 例如：MAC:32-a3-58-90-be-cc。

注意

在创建侦听器时设置 Address 值。

支持的 cmdlet

• New-Item

Capability <枚举>

使用插件时，此参数指定在此统一资源标识符 (URI) 上受支持的操作。 必须为该 URI 支持的每种类型的操作都创建一个条目。 可以指定给定操作的任何有效属性，如果操作支持这样做。

这些属性包括 SupportsFiltering 和 SupportsFragment。

• Create：URI 上支持 Create 操作。
  • 如果 Create 操作支持 SupportFragment 属性这一概念，则使用该属性。
  • SupportFiltering 属性对 Create 操作无效，应设置为“False”。

  注意

  如果还支持 Shell 操作，则此操作对于 URI 无效。

• Delete：URI 上支持 Delete 操作。
  • 如果 Delete 操作支持 SupportFragment 属性这一概念，则使用该属性。
  • SupportFiltering 属性对 Delete 操作无效，应设置为“False”。

  注意

  如果还支持 Shell 操作，则此操作对于 URI 无效。

• Enumerate：URI 上支持 Enumerate 操作。
  • SupportFragment 属性不受 Enumerate 操作支持，并且应设置为 False。
  • SupportFiltering 属性有效，如果插件支持筛选，则此属性应设置为“True”。

  注意

  如果还支持 Shell 操作，则此操作对于 URI 无效。

• Get：URI 上支持 Get 操作。
  • 如果 Get 操作支持 SupportFragment 属性这一概念，则使用该属性。
  • SupportFiltering 属性对 Get 操作无效，应设置为“False”。

  注意

  如果还支持 Shell 操作，则此操作对于 URI 无效。

• Invoke：URI 上支持 Invoke 操作。
  • SupportFragment 属性不受 Invoke 操作支持，并且应设置为 False。
  • SupportFiltering 属性无效，并且应设置为“False”。

  注意

  如果还支持 Shell 操作，则此操作对于 URI 无效。

• Put：URI 上支持 Put 操作。
  • 如果 Put 操作支持 SupportFragment 属性这一概念，则使用该属性。
  • SupportFiltering 属性对 Put 操作无效，应设置为“False”。

  注意

  如果还支持 Shell 操作，则此操作对于 URI 无效。

• Subscribe：URI 上支持 Subscribe 操作。
  • SupportFragment 属性不受 Subscribe 操作支持，并且应设置为 False。
  • SupportFiltering 属性对 Subscribe 操作无效，应设置为“False”。

  注意

  如果还支持 Shell 操作，则此操作对于 URI 无效。

• Shell：URI 上支持 Shell 操作。
  • SupportFragment 属性不受 Shell 操作支持，并且应设置为“False”。
  • SupportFiltering 属性对 Shell 操作无效，应设置为“False”。

  注意

  如果还支持任何其他操作，则此操作对于 URI 无效。

  注意

  如果为 URI 配置了 Shell 操作，则将在 WS-Management (WinRM) 服务中从内部处理 Get、Put、Create、Delete、Invoke 和 Enumerate 操作，以管理 shell。 因此，插件不能处理这些操作。

支持的 cmdlet

• New-Item

CertificateThumbprint <字符串>

指定服务证书的指纹。

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

支持的 cmdlet

• New-Item

Enabled <布尔值>

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

支持的 cmdlet

• New-Item

FileName (Plugin) <字符串>

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

支持的 cmdlet

• New-Item

HostName <字符串>

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

该值必须是完全限定的域名、IPv4 或 IPv6 文字字符串或通配符。

支持的 cmdlet

• New-Item

Issuer <字符串>

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

支持的 cmdlet

• New-Item

Plugin 和 WS-Management 插件是本机动态链接库 (DLL)

该插件插入和扩展 WS-Management 的功能。 WSW-Management 插件 API 提供的功能使用户能够通过对支持的资源 URI 和操作实施某些 API 来编写插件。 为 WS-Management (WinRM) 服务或 Internet Information Services (IIS) 配置插件后，这些插件将分别在 WS-Management 主机或 IIS 主机中加载。 远程请求会路由到这些插件的入口点以执行操作。

支持的 cmdlet

• New-Item

Port <无符号短整数>

指定为其创建此侦听器的 TCP 端口。 可以指定 1 到 65535 的任何值。

支持的 cmdlet

• New-Item

Resource <字符串>

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

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

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

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

支持的 cmdlet

• New-Item

Resource <字符串>

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

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

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

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

支持的 cmdlet

• New-Item

SDKVersion <字符串>

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

支持的 cmdlet

• New-Item

Subject <字符串>

指定由证书标识的实体。

支持的 cmdlet

• New-Item

Transport <字符串>

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

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

支持的 cmdlet

• New-Item

URI <字符串>

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

支持的 cmdlet

• New-Item

URLPrefix <字符串>

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

支持的 cmdlet

• New-Item

Value <字符串>

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

支持的 cmdlet

• New-Item

XMLRenderingType <字符串>

指定通过 WSMAN_DATA 对象传递给插件的 XML 所采用的格式。 下面是有效值：

• Text：传入的 XML 数据包含在 WSMAN_DATA_TYPE_TEXT 结构中，该结构将该 XML 表示为 PCWSTR 内存缓冲区。
• XMLReader：传入的 XML 数据包含在 WSMAN_DATA_TYPE_WS_XML_READER 结构中，该结构将该 XML 表示为在“WebServices.h”头文件中定义的 XmlReader 对象。

支持的 cmdlet

• New-Item

使用管道

提供程序 cmdlet 接受管道输入。 可以使用管道将提供程序数据从一个 cmdlet 发送到另一个提供程序 cmdlet 来简化任务。 若要详细了解如何将管道与提供程序 cmdlet 配合使用，请参阅本文中提供的 cmdlet 参考。

获取帮助

从 Windows PowerShell 3.0 开始，你可以获取有关提供程序 cmdlet 的自定义帮助主题，它们介绍了这些 cmdlet 在文件系统驱动器中的行为方式。

若要获取针对文件系统驱动器进行自定义的帮助主题，请在文件系统驱动器中运行 Get-Help 命令，或使用 Get-Help 的 -Path 参数来指定文件系统驱动器。

Get-Help Get-ChildItem

Get-Help Get-ChildItem -Path wsman:

另请参阅

• about_Providers