Создает новый элемент.

Синтаксис

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 (конкретного ресурса).






См. также