Создает новый элемент.
Синтаксис
New-Item [-URI <Uri>] [-SDDL <string>] [-ExactMatch] [-Confirm] [-WhatIf] [<CommonParameters>]
Описание
Командлет New-Item создает новый элемент и задает его значение. Типы создаваемых элементов зависят от местоположения этих элементов. Например, в файловой системе командлет New-Item создает файлы и папки. В реестре командлет New-Item создает разделы и записи реестра.
В каталоге Security с помощью командлета New-Item можно создать и настроить безопасность подключаемого модуля.
Параметры
-URI <Uri>
Определяет URI, доступ к которому авторизуется на основании значения параметра Sddl.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-SDDL <string>
Задает строку в формате языка определения дескрипторов безопасности (SDDL) для записи управления доступом. Эта строка определяет параметры
безопасности, используемые для авторизации доступа к заданному URI ресурса.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-ExactMatch
Задает правила использования параметров безопасности, заданных параметром Sddl. Если параметр ExactMatch имеет значение
True, параметры безопасности в параметре Sddl используются только для авторизации попыток доступа к URI, в точности соответствующему заданному параметром URI.
Если параметр ExactMatch имеет значение False, параметры безопасности в параметре Sddl используются для авторизации доступа к URI, которые начинаются
со строки, заданной параметром URI.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-Confirm
Запрашивает подтверждение перед выполнением команды.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-WhatIf
Описывает, что произойдет при выполнении команды, без ее фактического выполнения.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
<CommonParameters>
Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.
Ввод и вывод
Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.
|
Входные данные |
System.Object Значение для нового элемента можно передать командлету New-Item по конвейеру. |
|
Выходные данные |
Любой |
Примечания
Командлет New-Item предназначен для работы с данными, предоставляемыми любым поставщиком. Чтобы получить список поставщиков, доступных в текущем сеансе, введите команду "Get-PsProvider". Дополнительные сведения см. в разделе About_Providers.
Пример 1
C:\PS>New-Item -path WSMan:\localhost\Plugin\TestPlugin\Resources\Resource_5967683\Security -Sddl "O:NSG:BAD:P(A;;GA;;;BA)S:P(AU;FA;GA;;;WD)(AU;SA;GWGX;;;WD)" Эта команда создает запись безопасности в каталоге Security ресурса Resource_5967683 (конкретного ресурса).