Создает новый псевдоним.

Синтаксис

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 для отображения всех данных о псевдониме.

New-Alias