Remove-Alias (Microsoft.PowerShell.Utility)

Remove-Alias

Модуль:: Microsoft.PowerShell.Utility

Удалить псевдоним из текущего сеанса.

Синтаксис

Remove-Alias
      [-Name] <String[]>
      [-Scope <String>]
      [-Force]
      [<CommonParameters>]

Описание

Командлет Remove-Alias удаляет псевдоним из текущего сеанса PowerShell. Чтобы удалить псевдоним, если для свойства Option установлено значение ReadOnly, используйте параметр Force.

Командлет Remove-Alias появился в PowerShell 6.0.

Примеры

Пример 1. Удаление псевдонима

В этом примере удаляется псевдоним с именем del, который представляет командлет Remove-Item.

Remove-Alias -Name del

Пример 2. Удаление всех неконстантных псевдонимов

В этом примере удаляются все псевдонимы из текущего сеанса PowerShell, за исключением псевдонимов, у которых для свойства Options установлено значение Constant. После выполнения команды псевдонимы станут доступны в других сеансах PowerShell или в новых сеансах PowerShell.

Get-Alias | Where-Object { $_.Options -NE "Constant" } | Remove-Alias -Force

Get-Alias получает все псевдонимы в сеансе PowerShell и отправляет объекты по конвейеру. Where-Object использует блок сценария, а автоматическая переменная ($_) и свойство Options представляют текущий объект конвейера. Параметр NE (не равен) выбирает объекты, для которых для параметра Параметры не установлено значение Константа. Remove-Alias использует параметр Force для удаления псевдонимов, включая псевдонимы, доступные только для чтения, из сеанса PowerShell. Параметр Force не может удалить псевдонимы Constant.

Параметры

-Force

Указывает, что командлет удаляет псевдоним, включая псевдонимы, для свойства Option которого установлено значение ReadOnly. Параметр Force не может удалить псевдоним, если для свойства Option установлено значение Constant.

Тип :: SwitchParameter
Позиция:: Именованный
Значение по умолчанию:: False
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

-Name

Указывает имя псевдонима, который нужно удалить.

Тип :: String[]
Позиция:: 0
Значение по умолчанию:: None
Необходимый:: True
Примите ввод конвейера:: True
Принимайте подстановочные знаки:: False

-Scope

Влияет только на псевдонимы в указанной области. Область действия по умолчанию — Локальная. Дополнительные сведения см. в разделе about_Scopes.

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

Global

Local

Script

Число относительно текущей области (от 0 до количества областей, где 0 — текущая область, а 1 — ее родительский).

Тип :: String
Позиция:: Именованный
Значение по умолчанию:: Местный
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

Входы

Строка[]

В этот командлет можно передать объект псевдонима.

Выходы

Нет

Этот командлет не возвращает никаких результатов.

Примечания

Изменения влияют только на текущую область действия. Чтобы удалить псевдоним из всех сеансов, добавьте команду Remove-Alias в свой профиль PowerShell.

Дополнительные сведения см. в разделе about_Aliases.