Поиск по сайту:

о провайдере WSMan

Имя провайдера

WSMan

Диски

WSMan:

Краткое описание

Предоставляет доступ к информации о конфигурации веб-служб управления (WS-Management).

Подробное описание

Эта информация относится только к PowerShell, работающему в Windows.

Поставщик WSMan для PowerShell позволяет добавлять, изменять, очищать и удалять данные конфигурации WS-Management на локальных или удаленных компьютерах.

Поставщик WSMan предоставляет диск PowerShell со структурой каталогов, соответствующей логической группировке параметров конфигурации WS-Management. Эти группы известны как контейнеры.

Начиная с Windows PowerShell 3.0, поставщик WSMan был обновлен для поддержки новых свойств для конфигураций сеансов, таких как OutputBufferingMode. Конфигурации сеанса отображаются как элементы в каталоге плагинов на диске WSMan:, а свойства отображаются как элементы в каждой конфигурации сеанса.

Поставщик WSMan поддерживает следующие командлеты, описанные в этой статье.

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

Примечание

Вы можете использовать команды на диске WSMan:, чтобы изменить значения новых свойств. Однако вы не можете использовать диск WSMan: в PowerShell 2.0 для изменения свойств, представленных в Windows PowerShell 3.0. Хотя ошибок не возникает, команды неэффективны. Чтобы изменить эти параметры, используйте диск WSMan в Windows PowerShell 3.0.

Организация WSMan: Драйв

  • Клиент: вы можете настроить различные аспекты клиента WS-Management. Информация о конфигурации хранится в реестре.

  • Сервис: вы можете настроить различные аспекты службы WS-Management. Информация о конфигурации хранится в реестре.

    Примечание

    Конфигурацию службы иногда называют конфигурацией сервера.

  • Shell: вы можете настроить различные аспекты оболочки WS-Management, например параметр, разрешающий удаленный доступ к оболочке (AllowRemoteShellAccess) и максимальное разрешенное количество одновременных пользователей (MaxConcurrentUsers).

  • Прослушиватель: вы можете создать и настроить прослушиватель. Прослушиватель — это служба управления, которая реализует протокол WS-Management для отправки и получения сообщений.

  • Плагин: плагины загружаются и используются службой WS-Management для предоставления различных функций. По умолчанию PowerShell предоставляет три плагина:

    • Плагин пересылки событий.
    • Плагин Microsoft.PowerShell.
    • Подключаемый модуль поставщика инструментария управления Windows (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 для изменения текущего местоположения на диск WSMan:.

Set-Location WSMan:

Чтобы вернуться к диску файловой системы, введите имя диска. Например, введите.

Set-Location C:

Переход к удаленному системному хранилищу

Эта команда использует команду Set-Location для изменения текущего местоположения на корневое расположение в удаленном системном хранилище. Используйте обратную косую черту \ или косую черту /, чтобы указать уровень диска WSMan:.

Set-Location -Path  WSMan:\SERVER01

Примечание

В приведенной выше команде предполагается, что соединение с удаленной системой уже существует.

Отображение содержимого WSMan: Диск

Эта команда использует командлет Get-Childitem для отображения хранилищ WS-Management в расположении хранилища Localhost.

Get-ChildItem -path WSMan:\Localhost

Если вы находитесь на диске WSMan:, вы можете опустить имя диска.

Эта команда использует командлет Get-Childitem для отображения хранилищ WS-Management в расположении хранилища «SERVER01» на удаленном компьютере.

Get-ChildItem -path WSMan:\SERVER01

Примечание

В приведенной выше команде предполагается, что соединение с удаленной системой уже существует.

Установка значения элементов на диске WSMAN:

Вы можете использовать командлет Set-Item для изменения параметров конфигурации на диске 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 поддерживает дополнительный параметр -Concatenate, который добавляет значение, а не изменяет его. В следующем примере новое значение «*.domain2.com» будет добавлено к старому значению, хранящемуся в TrustedHost:.

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

Создание элементов на диске WSMAN:

Создание нового слушателя

Командлет New-Item создает элементы на диске поставщика. У каждого поставщика есть разные типы элементов, которые вы можете создавать. На диске WSMAN: вы можете создавать прослушиватели, которые вы настраиваете для получения и ответа на удаленные запросы. Следующая команда создает новый прослушиватель HTTP с помощью командлета New-Item.

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

Создание новой записи ресурса

Эта команда создает запись ресурса в каталоге Resources TestPlugin. Эта команда предполагает, что TestPlugin был создан с помощью отдельной команды.

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

Создание новой записи безопасности для ресурса

Эта команда создает запись безопасности в каталоге безопасности Resource_5967683 (определенный ресурс). Эта команда предполагает, что запись ресурса была создана с помощью отдельной команды.

$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)"

Создание нового сертификата клиента

Эта команда создает запись ClientCertificate, которую может использовать клиент WS-Management. Новый ClientCertificate появится в каталоге ClientCertificate как «ClientCertificate_1234567890». Все параметры являются обязательными. Эмитент должен быть отпечатком сертификата эмитента.

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

Создание нового параметра инициализации

Эта команда создает параметр инициализации с именем «testparametername» в каталоге «InitializationParameters». Эта команда предполагает, что «TestPlugin» был создан с помощью отдельной команды.

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

Динамические параметры

Динамические параметры — это параметры командлета, которые добавляются поставщиком PowerShell и доступны только тогда, когда командлет используется на диске с поддержкой поставщика.

Адрес <Строка>

Указывает адрес, для которого был создан этот прослушиватель. Значение может быть одним из следующих:

  • Буквальная строка «*». (Подстановочный знак (*) позволяет команде связать все IP-адреса на всех сетевых адаптерах.)
  • Литеральная строка «IP:», за которой следует действительный IP-адрес либо в десятичном формате IPv4, либо в клонированном шестнадцатеричном формате IPv6.
  • Буквальная строка «MAC:», за которой следует MAC-адрес адаптера. Например: MAC:32-a3-58-90-be-cc.

Примечание

Значение адреса задается при создании прослушивателя.

Поддерживаемые командлеты

  • New-Item

Возможность <Перечисление>

При работе с Плагинами этот параметр указывает операцию, которая поддерживается с этим универсальным идентификатором ресурса (URI). Вам необходимо создать одну запись для каждого типа операции, которую поддерживает URI. Вы можете указать любые допустимые атрибуты для данной операции, если операция поддерживает это.

К этим атрибутам относятся SupportsFiltering и SupportsFragment.

  • Создать: операции создания поддерживаются в URI.

    • Атрибут SupportFragment используется, если операция Create поддерживает эту концепцию.
    • Атрибут SupportFiltering НЕдопустим для операций создания и должен иметь значение «False».

    Примечание

    Эта операция недействительна для URI, если также поддерживаются операции оболочки.

  • Удалить: операции удаления поддерживаются для URI.

    • Атрибут SupportFragment используется, если операция удаления поддерживает эту концепцию.
    • Атрибут SupportFiltering НЕдопустим для операций удаления, и для него должно быть установлено значение «False».

    Примечание

    Эта операция недействительна для URI, если также поддерживаются операции оболочки.

  • Enumerate: операции перечисления поддерживаются для URI.

    • Атрибут SupportFragment НЕ поддерживается для операций Enumerate, и для него должно быть установлено значение False.
    • Атрибут SupportFiltering действителен, и если плагин поддерживает фильтрацию, для этого атрибута должно быть установлено значение «True».

    Примечание

    Эта операция недействительна для URI, если также поддерживаются операции оболочки.

  • Get: операции Get поддерживаются для URI.

    • Атрибут SupportFragment используется, если операция Get поддерживает эту концепцию.
    • Атрибут SupportFiltering НЕдопустим для операций Get и должен иметь значение «False».

    Примечание

    Эта операция недействительна для URI, если также поддерживаются операции оболочки.

  • Вызов: операции вызова поддерживаются в URI.

    • Атрибут SupportFragment не поддерживается для операций Invoke, и ему должно быть присвоено значение False.
    • Атрибут SupportFiltering недействителен, и для него должно быть установлено значение «False».

    Примечание

    Эта операция недействительна для URI, если также поддерживаются операции оболочки.

  • Put: операции put поддерживаются для URI.

    • Атрибут SupportFragment используется, если операция Put поддерживает эту концепцию.
    • Атрибут SupportFiltering недопустим для операций Put и должен иметь значение «False».

    Примечание

    Эта операция недействительна для URI, если также поддерживаются операции оболочки.

  • Подписаться: операции подписки поддерживаются с помощью URI.

    • Атрибут SupportFragment не поддерживается для операций подписки, и для него должно быть установлено значение False.
    • Атрибут SupportFiltering недопустим для операций подписки, и для него должно быть установлено значение «False».

    Примечание

    Эта операция недействительна для URI, если также поддерживаются операции оболочки.

  • Shell: операции оболочки поддерживаются в URI.

    • Атрибут SupportFragment не поддерживается для операций оболочки, и ему должно быть присвоено значение «False».
    • Атрибут SupportFiltering недопустим для операций оболочки, и для него должно быть установлено значение «False».

    Примечание

    Эта операция недействительна для URI, если также поддерживается ЛЮБАЯ другая операция.

    Примечание

    Если операция оболочки настроена для URI, операции Get, Put, Create, Delete, Invoke и Enumerate обрабатываются внутри службы WS-Management (WinRM) для управления оболочками. В результате плагин не может обрабатывать операции.

Поддерживаемые командлеты

  • New-Item

Отпечаток сертификата

Указывает отпечаток сертификата службы.

Это значение представляет собой строку двухзначных шестнадцатеричных значений в поле «Отпечаток» сертификата. Он указывает сертификат цифрового открытого ключа (X509) учетной записи пользователя, у которой есть разрешение на выполнение этого действия. Сертификаты используются при проверке подлинности на основе сертификатов клиентов. Их можно сопоставить только с локальными учетными записями пользователей, и они не работают с учетными записями домена. Чтобы получить отпечаток сертификата, используйте командлеты Get-Item или Get-ChildItem на диске PowerShell Cert:.

Поддерживаемые командлеты

  • New-Item

Включено <логическое значение>

Указывает, включен или отключен прослушиватель. По умолчанию установлено значение «Истина».

Поддерживаемые командлеты

  • New-Item

Имя файла (плагин)

Указывает имя файла подключаемого модуля операций. Любые переменные среды, помещенные в эту запись, будут расширены в контексте пользователя при получении запроса. Поскольку у каждого пользователя может быть своя версия одной и той же переменной среды, у каждого пользователя может быть свой подключаемый модуль. Эта запись не может быть пустой и должна указывать на действительный плагин.

Поддерживаемые командлеты

  • New-Item

Имя хоста <Строка>

Указывает имя хоста компьютера, на котором запущена служба WS-Management (WinRM).

Значение должно быть полным доменным именем, строкой литерала IPv4 или IPv6 или подстановочным знаком.

Поддерживаемые командлеты

  • New-Item

Эмитент <Строка>

Указывает имя центра сертификации, выдавшего сертификат.

Поддерживаемые командлеты

  • New-Item

Плагин <> Плагины WS-Management — это собственные библиотеки динамической компоновки (DLL).

которые подключаются к WS-Management и расширяют его функциональность. API подключаемого модуля WSW-Management предоставляет функциональные возможности, позволяющие пользователю писать подключаемые модули путем реализации определенных API для поддерживаемых URI ресурсов и операций. После настройки подключаемых модулей для службы WS-Management (WinRM) или для служб IIS они загружаются на узел WS-Management или на узел IIS соответственно. Удаленные запросы направляются в эти точки входа подключаемого модуля для выполнения операций.

Поддерживаемые командлеты

  • New-Item

Порт <короткое целое число без знака>

Указывает TCP-порт, для которого создается этот прослушиватель. Вы можете указать любое значение от 1 до 65535.

Поддерживаемые командлеты

  • New-Item

Ресурс <Строка>

Указывает конечную точку, представляющую отдельный тип операции управления или значения. Служба предоставляет один или несколько ресурсов, а некоторые ресурсы могут иметь более одного экземпляра. Ресурс управления аналогичен классу 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

Поддерживаемые командлеты

  • New-Item

Ресурс <Строка>

Указывает универсальный идентификатор ресурса (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

Поддерживаемые командлеты

  • New-Item

SDKVersion <Строка>

Указывает версию SDK подключаемого модуля WS-Management. Единственное допустимое значение — 1.

Поддерживаемые командлеты

  • New-Item

Тема <Строка>

Указывает сущность, идентифицируемую сертификатом.

Поддерживаемые командлеты

  • New-Item

Транспорт <Строка>

Указывает транспорт, который будет использоваться для отправки и получения запросов и ответов протокола WS-Management. Значение должно быть HTTP или HTTPS.

Примечание. Значение Transport задается при создании прослушивателя.

Поддерживаемые командлеты

  • New-Item

URI <Строка>

Идентифицирует URI, для которого разрешен доступ, на основе значения параметра Sddl.

Поддерживаемые командлеты

  • New-Item

URLPrefix

Префикс URL-адреса, по которому можно принимать запросы HTTP или HTTPS. Это строка, содержащая только символы [a-z], [A-Z], [9-0], подчеркивание (_) и обратную косую черту (/). Строка не должна начинаться или заканчиваться обратной косой чертой (/). Например, если имя компьютера — «SampleComputer», клиент WS-Management укажет http://SampleMachine/URLPrefix в адресе назначения.

Поддерживаемые командлеты

  • New-Item

Значение <строка>

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

Поддерживаемые командлеты

  • New-Item

XMLRenderingType

Указывает формат, в котором XML передается подключаемым модулям через объект WSMAN_DATA. Ниже приведены допустимые значения:

  • Текст: входящие XML-данные содержатся в структуре WSMAN_DATA_TYPE_TEXT, которая представляет XML как буфер памяти PCWSTR.
  • XMLReader: входящие XML-данные содержатся в структуре WSMAN_DATA_TYPE_WS_XML_READER, которая представляет XML как объект XmlReader, определенный в заголовочном файле WebServices.h.

Поддерживаемые командлеты

  • New-Item

Использование конвейера

Командлеты поставщика принимают входные данные конвейера. Вы можете использовать конвейер для упрощения задачи, отправляя данные поставщика из одного командлета в другой командлет поставщика. Чтобы узнать больше о том, как использовать конвейер с командлетами поставщика, см. ссылки на командлеты, приведенные в этой статье.

Получение помощи

Начиная с Windows PowerShell 3.0, вы можете получить настраиваемые разделы справки для командлетов поставщика, в которых объясняется, как эти командлеты ведут себя на диске файловой системы.

Чтобы получить разделы справки, настроенные для диска с файловой системой, запустите команду Get-Help на диске с файловой системой или используйте параметр -Path командлета Get-Help, чтобы указать диск с файловой системой.

Get-Help Get-ChildItem

Get-Help Get-ChildItem -Path wsman:

См. также

  • about_Providers