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 (не равно) выбирает объекты, для которых для параметра Options не задано значение Constant. Remove-Alias использует параметр Force для удаления псевдонимов, включая псевдонимы только для чтения, из сеанса PowerShell.

Параметры

-Force

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

Type:SwitchParameter
Position:Named
Default value:False
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

-Scope

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

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

  • Глобальный
  • Local
  • Скрипт
  • Номер относительно текущей области (от 0 до количества областей, где 0 — это текущая область, а 1 — ее родительская область).
Type:String
Position:Named
Default value:Local
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Входные данные

String[]

Объект псевдонима можно передать по конвейеру в Remove-Alias.

Выходные данные

None

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

Примечания

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

Подробнее см. в статье about_Aliases.