Поделиться через

Remove-Alias

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

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

Синтаксис

Default (по умолчанию) 

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.

Свойства параметра

Тип:SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Name

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

Свойства параметра

Тип:

String[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:0
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Scope

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

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

  • Global
  • Local
  • Script
  • Число относительно текущей области (от 0 до числа областей, где 0 является текущей областью, а 1 — родительским)

Свойства параметра

Тип:String
Default value:Local
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

String

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

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

None

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

Примечания

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

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