Set-Item

Синтаксис

Path (Default) - All providers

Set-Item
    [-Path] <String[]>
    [[-Value] <Object>]
    [-Force]
    [-PassThru]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

LiteralPath - All providers

Set-Item
    [[-Value] <Object>]
    -LiteralPath <String[]>
    [-Force]
    [-PassThru]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Path (Default) - Alias and Function providers

Set-Item
    [-Path] <string[]>
    [[-Value] <Object>]
    [-Force]
    [-PassThru]
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [-Options <ScopedItemOptions>]
    [<CommonParameters>]

LiteralPath - Alias and Function providers

Set-Item
    [[-Value] <Object>]
    -LiteralPath <string[]>
    [-Force]
    [-PassThru]
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [-Options <ScopedItemOptions>]
    [<CommonParameters>]

Path (Default) - Registry provider

Set-Item
    [-Path] <string[]>
    [[-Value] <Object>]
    [-Force]
    [-PassThru]
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [-Type <RegistryValueKind>]
    [<CommonParameters>]

LiteralPath - Registry provider

Set-Item
    [[-Value] <Object>]
    -LiteralPath <string[]>
    [-Force]
    [-PassThru]
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [-Type <RegistryValueKind>]
    [<CommonParameters>]

Описание

Примеры

Пример 1. Создание псевдонима

Set-Item -Path Alias:np -Value "C:\windows\notepad.exe"

Пример 2. Изменение значения переменной среды

Set-Item -Path Env:UserRole -Value "Administrator"

Пример 3. Изменение функции запроса

Set-Item -Path Function:prompt -Value {
    'PS '+ (Get-Date -Format t) + " " + (Get-Location) + '> '
}

Пример 4. Настройка параметров функции запроса

Set-Item -Path Function:prompt -Options "AllScope,ReadOnly"

Параметры

-Confirm

Запрашивает подтверждение перед запуском cmdlet.

Свойства параметра

Наборы параметров

-Credential

Свойства параметра

Наборы параметров

-Exclude

Указывает как строковый массив, элемент или элементы, которые этот командлет исключает в операции. Значение этого параметра квалифифициирует параметр Path. Введите элемент пути или шаблон, например *.txt. Разрешено использование подстановочных символов. Параметр Исключить действует только в том случае, если команда включает содержимое элемента, например C:\Windows\*, где подстановочный знак указывает содержимое каталога C:\Windows.

Свойства параметра

Наборы параметров

-Filter

Указывает фильтр для квалификации параметра Path. Поставщик файловой системы является единственным установленным поставщиком PowerShell, который поддерживает использование фильтров. Синтаксис языка фильтрации файловой системы вы можете найти в about_Wildcards. Фильтры более эффективны, чем другие параметры, так как поставщик применяет их, когда командлет получает объекты, а не чтобы PowerShell фильтровал объекты после их получения.

Свойства параметра

Наборы параметров

-Force

Принуждает командлет изменять элементы, которые в противном случае невозможно было бы изменить, такие как псевдонимы только для чтения или переменные. Командлет не может изменять псевдонимы констант или переменные. Реализация зависит от поставщика к поставщику. Дополнительные сведения см. в разделе о поставщиках. Даже при использовании параметра Force командлет не может переопределить ограничения безопасности.

Свойства параметра

Наборы параметров

-Include

Указывает, как строковый массив, элемент или элементы, которые этот командлет включает в операцию. Значение этого параметра квалифифициирует параметр Path. Введите элемент пути или шаблон, например "*.txt". Разрешено использование подстановочных символов. Параметр Include действует только в том случае, если команда включает содержимое элемента, например C:\Windows\*, где подстановочный знак указывает содержимое каталога C:\Windows.

Свойства параметра

Наборы параметров

-LiteralPath

Указывает путь к одному или нескольким расположениям. Значение LiteralPath используется именно так, как оно введено. Никакие символы не интерпретируются как подстановочные знаки. Если путь содержит escape-символы, заключите его в одинарные кавычки. Одинарные кавычки указывают PowerShell на то, что не следует интерпретировать какие-либо символы как управляющие последовательности.

Дополнительную информацию см. в разделе about_Quoting_Rules.

Свойства параметра

Наборы параметров

-Options

Это динамический параметр, доступный поставщиками псевдонима и функции . Для получения дополнительной информации см. разделы about_Alias_Provider и about_Function_Provider.

Указывает значение свойства Options псевдонима.

Допустимые значения:

• None: псевдоним не имеет ограничений (значение по умолчанию)
• ReadOnly: псевдоним можно удалить, но не может быть изменен без использования параметра Force
• Constant: псевдоним нельзя удалить или изменить
• Private: Этот псевдоним доступен только в текущей области
• AllScope: псевдоним копируется в любые новые области, которые создаются
• Unspecified: параметр не указан

Свойства параметра

Наборы параметров

-PassThru

Передает объект, представляющий элемент конвейеру. По умолчанию этот командлет не создает выходные данные.

Свойства параметра

Наборы параметров

-Path

Указывает путь к расположению элементов. Разрешено использование подстановочных символов.

Свойства параметра

Наборы параметров

-Type

Это динамический параметр, доступный поставщиком реестра. Поставщик реестра и этот параметр доступен только в Windows.

Указывает тип свойства, добавляемого этим командлетом. Допустимые значения для этого параметра:

• String: указывает строку, завершаемую значением NULL. Используется для значений REG_SZ.
• ExpandString. Указывает строку с завершающим нулевым символом, которая содержит неразвёрнутые ссылки на переменные среды, развернутые при извлечении значения. Используется для значений REG_EXPAND_SZ.
• Binary: указывает двоичные данные в любой форме. Используется для значений REG_BINARY.
• DWord: указывает 32-разрядное двоичное число. Используется для значений REG_DWORD.
• MultiString: указывает массив строк, завершаемых значением NULL, прерванным двумя символами NULL. Используется для значений REG_MULTI_SZ.
• Qword: указывает 64-разрядное двоичное число. Используется для значений REG_QWORD.
• Unknown. Указывает неподдерживаемый тип данных реестра, например значения REG_RESOURCE_LIST.

Свойства параметра

Наборы параметров

-Value

Задает новое значение для элемента.

Свойства параметра

Наборы параметров

-WhatIf

Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.

Свойства параметра

Наборы параметров

CommonParameters

Входные данные

Object

Выходные данные

None

Object

Примечания

Связанные ссылки

• Очистить-Объект
• Copy-Item
• Get-Item
• Invoke-Item (вызвать элемент)
• Переместить-Объект
• Новый-объект
• Удалить-Элемент
• Переименовать-Элемент
• о_Поставщиках