Sdílet prostřednictvím

Remove-Alias

  • Reference
Modul:
Microsoft.PowerShell.Utility

Odeberte alias z aktuální relace.

Syntaxe

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

Description

Rutina Remove-Alias odebere alias z aktuální relace PowerShellu. Pokud chcete odebrat alias s vlastností Option nastavenou na jen pro čtení, použijte parametr Force.

Rutina Remove-Alias byla představena v PowerShellu 6.0.

Příklady

Příklad 1 – Odebrání aliasu

Tento příklad odebere alias s názvem del, který představuje rutinu Remove-Item.

Remove-Alias -Name del

Příklad 2 – Odebrání všech aliasů, které nejsou konstanty

Tento příklad odebere všechny aliasy z aktuální relace PowerShellu s výjimkou aliasů s vlastností Options nastavenou na Konstanta. Po spuštění příkazu jsou aliasy k dispozici v jiných relacích PowerShellu nebo v nových relacích PowerShellu.

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

Get-Alias získá všechny aliasy v relaci PowerShellu a odešle objekty dolů kanálu. Where-Object používá blok skriptu a automatická proměnná ($_) a vlastnost Options představuje aktuální objekt kanálu. Parametr NE (nerovná se), vybere objekty, které nemají hodnotu Možnosti nastavenou na konstantní. Remove-Alias používá parametr Force k odebrání aliasů, včetně aliasů jen pro čtení, z relace PowerShellu. Parametr Force nemůže odebrat aliasy konstanty.

Parametry

-Force

Označuje, že rutina odebere alias, včetně aliasů s vlastností Option nastavenou na ReadOnly. Parametr Force nemůže odebrat alias s vlastností Option nastavenou na Konstantní.

Typ:SwitchParameter
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Name

Určuje název aliasu, který se má odebrat.

Typ:String[]
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Scope

Ovlivňuje pouze aliasy v zadaném oboru. Výchozí obor je místní. Další informace najdete v tématu about_Scopes.

Přijatelné hodnoty pro tento parametr jsou:

  • Global
  • Local
  • Script
  • Číslo relativní k aktuálnímu oboru (0 až počet oborů, kde 0 je aktuální obor a 1 je jeho nadřazený)
Typ:String
Position:Named
Default value:Local
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

String[]

Objekt aliasu můžete do této rutiny převést.

Výstupy

None

Tato rutina nevrátí žádný výstup.

Poznámky

Změny mají vliv jenom na aktuální obor. Pokud chcete odebrat alias ze všech relací, přidejte do profilu PowerShellu příkaz Remove-Alias.

Další informace naleznete v tématu about_Aliases.