Создает новый псевдоним.
Синтаксис
New-Alias [-Name] <string> [-Value] <string> [-Description <string>] [-Force] [-Option {<None> | <ReadOnly> | <Constant> | <Private> | <AllScope>}] [-PassThru] [-Scope <string>] [-Confirm] [-WhatIf] [<CommonParameters>]
Описание
Командлет New-Alias создает новый псевдоним в текущем сеансе Windows PowerShell. Псевдонимы, созданные с помощью командлета New-Alias, не сохраняются после окончания сеанса или закрытия Windows PowerShell. Командлет Export-Alias можно использовать для сохранения сведений о псевдонимах в файле. Сохраненные сведения о псевдонимах можно извлечь с помощью командлета Import-Alias.
Параметры
-Description <string>
Задает описание псевдонима. Можно ввести любую строку. Если описание содержит пробелы, его нужно заключить в кавычки.
Обязательно? |
false |
Позиция? |
named |
Значение по умолчанию |
|
Принимать входные данные из конвейера? |
false |
Принимать подстановочные знаки? |
false |
-Force
Если задан, ведет себя как командлет Set-Alias, когда псевдоним с таким именем уже существует.
Обязательно? |
false |
Позиция? |
named |
Значение по умолчанию |
|
Принимать входные данные из конвейера? |
false |
Принимать подстановочные знаки? |
false |
-Name <string>
Задает новый псевдоним. В псевдониме можно использовать любые буквы или цифры, но первым знаком не может быть цифра.
Обязательно? |
true |
Позиция? |
1 |
Значение по умолчанию |
|
Принимать входные данные из конвейера? |
true (ByPropertyName) |
Принимать подстановочные знаки? |
false |
-Option <ScopedItemOptions>
Определяет одно или несколько необязательных свойств псевдонима. Допустимые значения:
-- None: не определяет параметров (по умолчанию).
-- ReadOnly: псевдоним нельзя изменить, если только не использовать параметр Force.
-- Constant: псевдоним нельзя изменить, даже если использовать параметр Force.
-- Private: псевдоним доступен только в области, определенной параметром Scope. Он невидим за пределами области.
Обязательно? |
false |
Позиция? |
named |
Значение по умолчанию |
|
Принимать входные данные из конвейера? |
false |
Принимать подстановочные знаки? |
false |
-PassThru
Возвращает объект, представляющий новый псевдоним. По умолчанию этот командлет не формирует никаких выходных данных.
Обязательно? |
false |
Позиция? |
named |
Значение по умолчанию |
|
Принимать входные данные из конвейера? |
false |
Принимать подстановочные знаки? |
false |
-Scope <string>
Задает область нового псевдонима. Допустимые значения: "Global", "Local", "Script" или номер относительно текущей области (от 0 до количества областей, где 0 — текущая область, а 1 — ее родительская область). По умолчанию используется значение "Local". Дополнительные сведения см. в разделе about_Scopes.
Обязательно? |
false |
Позиция? |
named |
Значение по умолчанию |
|
Принимать входные данные из конвейера? |
false |
Принимать подстановочные знаки? |
false |
-Value <string>
Задает имя командлета или элемента команды, для которого создается псевдоним.
Обязательно? |
true |
Позиция? |
2 |
Значение по умолчанию |
|
Принимать входные данные из конвейера? |
true (ByPropertyName) |
Принимать подстановочные знаки? |
false |
-Confirm
Запрашивает подтверждение перед выполнением команды.
Обязательно? |
false |
Позиция? |
named |
Значение по умолчанию |
|
Принимать входные данные из конвейера? |
false |
Принимать подстановочные знаки? |
false |
-WhatIf
Описывает, что произойдет при выполнении команды, без ее фактического выполнения.
Обязательно? |
false |
Позиция? |
named |
Значение по умолчанию |
|
Принимать входные данные из конвейера? |
false |
Принимать подстановочные знаки? |
false |
<CommonParameters>
Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.
Ввод и вывод
Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.
Входные данные |
Нет Передать входные данные этому командлету по конвейеру невозможно. |
Выходные данные |
Нет или System.Management.Automation.AliasInfo Если задан параметр Passthru, командлет New-Alias создает объект System.Management.Automation.AliasInfo, представляющий новый псевдоним. В противном случае этот командлет не формирует никаких выходных данных. |
Примечания
Для создания нового псевдонима используйте командлет Set-Alias или New-Alias. Для изменения псевдонима используйте командлет Set-Alias. Для удаления псевдонима используйте командлет Remove-Item.
Пример 1
C:\PS>new-alias list get-childitem Описание ----------- Эта команда создает для командлета Get-ChildItem псевдоним "list".
Пример 2
C:\PS>new-alias -name w -value get-wmiobject -description "quick wmi alias" -option ReadOnly C:\PS> get-alias -name w | format-list * Описание ----------- Эта команда создает для командлета Get-WMIObject псевдоним "w". Она назначает псевдониму описание "quick wmi alias" и делает псевдоним доступным только для чтения. В последней строке командлет Get-Alias возвращает новый псевдоним и передает его по конвейеру командлету Format-List для отображения всех данных о псевдониме.
См. также