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 не может удалить псевдонимы констант .

Параметры

-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.

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

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

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

String[]

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

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

None

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

Примечания

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

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