Set-Item
Изменяет значение элемента на значение, указанное в команде.
Синтаксис
Set-Item
[-Path] <string[]>
[[-Value] <Object>]
[-Force]
[-PassThru]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
Set-Item
[[-Value] <Object>]
-LiteralPath <string[]>
[-Force]
[-PassThru]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
Set-Item
[-Path] <string[]>
[[-Value] <Object>]
[-Force]
[-PassThru]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[-Options <ScopedItemOptions>]
[<CommonParameters>]
Set-Item
[[-Value] <Object>]
-LiteralPath <string[]>
[-Force]
[-PassThru]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[-Options <ScopedItemOptions>]
[<CommonParameters>]
Set-Item
[-Path] <string[]>
[[-Value] <Object>]
[-Force]
[-PassThru]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[-Type <RegistryValueKind>]
[<CommonParameters>]
Set-Item
[[-Value] <Object>]
-LiteralPath <string[]>
[-Force]
[-PassThru]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[-Type <RegistryValueKind>]
[<CommonParameters>]
Описание
Командлет Set-Item
изменяет значение элемента, например переменной или раздела реестра, на значение, указанное в команде.
Примеры
Пример 1. Создание псевдонима
Эта команда создает псевдоним np для Блокнота.
Set-Item -Path alias:np -Value "c:\windows\notepad.exe"
Пример 2. Изменение значения переменной среды
Эта команда изменяет значение переменной среды UserRole на Administrator.
Set-Item -Path env:UserRole -Value "Administrator"
Пример 3. Изменение функции запроса
Эта команда изменяет функцию запроса, чтобы она отображала время до пути.
Set-Item -Path function:prompt -Value {'PS '+ (Get-Date -Format t) + " " + (Get-Location) + '> '}
Пример 4. Настройка параметров функции запроса
Эта команда задает параметры AllScope и ReadOnly для функции запроса.
Эта команда использует динамический параметр Set-Item
"Параметры".
Параметр Options доступен только в Set-Item
том случае, если он используется с поставщиком псевдонимов или функций .
Set-Item -Path function:prompt -Options "AllScope,ReadOnly"
Параметры
-Confirm
Запрос подтверждения перед выполнением командлета.
Тип: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Credential
Примечание.
Этот параметр не поддерживается поставщиками, установленными с помощью PowerShell. Чтобы олицетворить другого пользователя или повысить свои учетные данные при выполнении этого командлета, используйте Invoke-Command.
Тип: | PSCredential |
Position: | Named |
Default value: | Current user |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-Exclude
Указывает как строковый массив, элемент или элементы, которые этот командлет исключает в операции. Значение этого параметра определяет параметр Path. Введите элемент пути или шаблон, например *.txt
. Можно использовать подстановочные знаки. Параметр Exclude действует только в том случае, если команда включает содержимое элемента, напримерC:\Windows\*
, где подстановочный знак указывает содержимое C:\Windows
каталога.
Тип: | String[] |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | True |
-Filter
Указывает фильтр для квалификации параметра Path . Поставщик FileSystem — единственный установленный поставщик PowerShell, поддерживающий использование фильтров. Синтаксис языка фильтра FileSystem можно найти в about_Wildcards. Фильтры более эффективны, чем другие параметры, так как поставщик применяет их, когда командлет получает объекты, а не фильтрует объекты После их получения.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | True |
-Force
Принудительно задает элементы, которые не могут быть изменены, например псевдоним только для чтения или переменные. С помощью этого командлета нельзя изменять постоянные псевдонимы или переменные. Применение этого параметра зависит от конкретного поставщика. Дополнительные сведения см. в about_Providers. Даже при использовании параметра Force командлет не может переопределить ограничения безопасности.
Тип: | SwitchParameter |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Include
Указывает, как строковый массив, элемент или элементы, которые этот командлет включает в операцию. Значение этого параметра определяет параметр Path. Введите элемент пути или шаблон, например "*.txt"
. Можно использовать подстановочные знаки. Параметр Include действует только в том случае, если команда содержит содержимое элемента, например C:\Windows\*
, где подстановочный знак указывает содержимое C:\Windows
каталога.
Тип: | String[] |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | True |
-LiteralPath
Указывает путь к одному или нескольким расположениям. Значение LiteralPath используется точно так же, как он типизированный. Никакие символы не интерпретируются как знаки подстановки. Если путь содержит escape-символы, заключите его в одинарные кавычки. Одинарные кавычки говорят PowerShell не интерпретировать какие-либо символы как escape-последовательности.
Дополнительные сведения см. в about_Quoting_Rules.
Тип: | String[] |
Aliases: | PSPath |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-Options
Это динамический параметр, доступный поставщиками псевдонимов и функций . Дополнительные сведения см. в about_Alias_Provider и about_Function_Provider.
Задает значение свойства Options псевдонима.
Допустимые значения:
None
: псевдоним не имеет ограничений (значение по умолчанию)ReadOnly
: псевдоним можно удалить, но не может быть изменен без использования параметра ForceConstant
: псевдоним нельзя удалить или изменитьPrivate
: псевдоним доступен только в текущей областиAllScope
: псевдоним копируется в любые новые области, созданныеUnspecified
: параметр не указан
Тип: | ScopedItemOptions |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-PassThru
Передает объект, представляющий элемент конвейеру. По умолчанию этот командлет не создает выходные данные.
Тип: | SwitchParameter |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Path
Указывает путь к расположению элементов. Можно использовать подстановочные знаки.
Тип: | String[] |
Position: | 0 |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | True |
-Type
Это динамический параметр, доступный поставщиком реестра . Поставщик реестра и этот параметр доступны только в Windows.
Указывает тип свойства, добавляемого этим командлетом. Допустимые значения для этого параметра:
String
: указывает строку, завершаемую значением NULL. Используется для REG_SZ значений.ExpandString
: указывает строку, завершающуюся значением NULL, которая содержит необъяснимые ссылки на переменные среды, развернутые при извлечении значения. Используется для значений REG_EXPAND_SZ.Binary
: указывает двоичные данные в любой форме. Используется для REG_BINARY значений.DWord
: указывает 32-разрядное двоичное число. Используется для значений REG_DWORD.MultiString
: указывает массив строк, завершаемых значением NULL, завершаемым двумя символами NULL. Используется для REG_MULTI_SZ значений.Qword
: указывает 64-разрядное двоичное число. Используется для REG_QWORD значений.Unknown
: указывает неподдерживаемый тип данных реестра, например REG_RESOURCE_LIST значения.
Тип: | RegistryValueKind |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-UseTransaction
Включает команду в активную транзакцию. Этот параметр доступен только при выполнении транзакции. Дополнительные сведения см. в about_Transactions.
Тип: | SwitchParameter |
Aliases: | usetx |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Value
Задает новое имя для элемента.
Тип: | Object |
Position: | 1 |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет при запуске командлета. Командлет не выполняется.
Тип: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Входные данные
Можно передать объект, представляющий новое значение элемента в этот командлет.
Выходные данные
None
По умолчанию этот командлет не возвращает выходные данные.
При использовании параметра PassThru этот командлет возвращает объект, представляющий элемент.
Примечания
Windows PowerShell включает следующие псевдонимы для Set-Item
:
si
Set-Item
не поддерживается поставщиком Файловой системы PowerShell. Чтобы изменить значения элементов в файловойSet-Content
системе, используйте командлет.В дисках
HKLM:
реестра иHKCU:
Set-Item
измените данные в значении раздела реестра (по умолчанию).- Чтобы создать и изменить имена разделов реестра, используйте
New-Item
командлет иRename-Item
командлет. - Чтобы изменить имена и данные в значениях реестра, используйте
New-ItemProperty
команды иSet-ItemProperty
Rename-ItemProperty
командлеты.
- Чтобы создать и изменить имена разделов реестра, используйте
Set-Item
предназначен для работы с данными, предоставляемыми любым поставщиком. Чтобы вывести список поставщиков, доступных в данном сеансе, введите командлетGet-PsProvider
. Дополнительные сведения см. в about_Providers.
Связанные ссылки
PowerShell