Remove-Alias

  • Reference
Modul:
Microsoft.PowerShell.Utility

Odeberte alias z aktuální relace.

Syntax

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

Description

Rutina Remove-Alias odebere alias z aktuální relace PowerShellu. Chcete-li odebrat alias s vlastností Option nastavenou na ReadOnly, 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 Options vlastnost představují aktuální objekt kanálu. Parametr NE (nerovná se) vybere objekty, které nemají hodnotu Options nastavenou na Konstanta. Remove-Alias pomocí parametru Force odebere aliasy, včetně aliasů jen pro čtení, z relace PowerShellu. Parametr Force nemůže odebrat konstantní aliasy.

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Scope

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

Tento parametr přijímá tyto hodnoty:

  • 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ý)
Type:String
Position:Named
Default value:Local
Required:False
Accept pipeline input:False
Accept wildcard characters: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 Remove-Alias příkaz.

Další informace najdete v tématu about_Aliases.