New-Alias
Создает новый псевдоним.
Синтаксис
New-Alias
[-Name] <String>
[-Value] <String>
[-Description <String>]
[-Option <ScopedItemOptions>]
[-PassThru]
[-Scope <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет New-Alias создает новый псевдоним в текущем сеансе PowerShell. Псевдонимы, созданные с помощью командлета New-Alias , не сохраняются после завершения сеанса или закрытия PowerShell. Командлет Export-Alias можно использовать для сохранения сведений о псевдонимах в файл. Позже вы сможете использовать Import-Alias для получения сведений о сохраненном псевдониме.
Примеры
Пример 1. Create псевдоним для командлета
PS C:\> New-Alias -Name "List" Get-ChildItem
Эта команда создает псевдоним с именем List для представления командлета Get-ChildItem.
Пример 2. Create псевдоним только для чтения для командлета
PS C:\> New-Alias -Name "W" -Value Get-WmiObject -Description "quick wmi alias" -Option ReadOnly
PS C:\> Get-Alias -Name "W" | Format-List *
Эта команда создает псевдоним С для представления командлета Get-WmiObject. Он создает описание, быстрый псевдоним WMI для псевдонима и делает его доступным только для чтения. В последней строке командлет Get-Alias возвращает новый псевдоним и передает его в командлет Format-List по конвейеру для отображения всех данных о псевдониме.
Параметры
-Confirm
Запрос подтверждения перед выполнением командлета.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Указывает описание псевдонима. Можно ввести любую строку. Если описание содержит пробелы, заключите его в кавычки.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Указывает, что командлет действует так же, как Set-Alias, если псевдоним с именем уже существует.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Указывает новый псевдоним. В псевдониме можно использовать любые буквы или цифры, но первым знаком не может быть цифра.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Option
Задает значение свойства Options псевдонима. Допустимые значения:
- Нет: псевдоним не имеет ограничений (значение по умолчанию)
- ReadOnly: псевдоним можно удалить, но изменить его можно только с помощью параметра Force .
- Константы: псевдоним не может быть удален или изменен.
- Частный: псевдоним доступен только в текущей область
- AllScope: псевдоним копируется во все новые области, которые создаются.
- Не указано: параметр не указан.
Чтобы просмотреть свойство Options всех псевдонимов в сеансе, введите Get-Alias | Format-Table -Property Name, Options -AutoSize
.
Type: | ScopedItemOptions |
Accepted values: | None, ReadOnly, Constant, Private, AllScope, Unspecified |
Position: | Named |
Default value: | [System.Management.Automation.ScopedItemOptions]::None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Возвращает объект, представляющий элемент, с которым вы работаете. По умолчанию этот командлет не создает выходные данные.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Scope
Указывает область действия нового псевдонима. Допустимые значения для этого параметра:
- Глобальный
- Local
- Скрипт
- Число относительно текущего область (от 0 до числа областей, где 0 — текущий область а 1 — родительский элемент).
По умолчанию используется значение Local. Дополнительные сведения см. в разделе about_Scopes.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Value
Указывает имя командлета или элемента команды, для которого создается псевдоним.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Показывает, что произойдет при запуске командлета. Командлет не выполняется.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Входные данные
None
В этот командлет нельзя передать входные данные.
Выходные данные
None or System.Management.Automation.AliasInfo
При использовании параметра PassthruNew-Alias создает объект System.Management.Automation.AliasInfo , представляющий новый псевдоним. В противном случае командлет не формирует никаких выходных данных.
Примечания
- Чтобы создать псевдоним, используйте
Set-Alias
илиNew-Alias
. Чтобы изменить псевдоним, используйте .Set-Alias
Чтобы удалить псевдоним, используйте .Remove-Item