Sdílet prostřednictvím

Remove-Alias

Modul:
Microsoft.PowerShell.Utility Module

Odeberte alias z aktuální relace.

Syntax

Default (Výchozí) 

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

Description

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

Cmdlet Remove-Alias byl představen 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 těch aliasů, které mají 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 předá objekty do roury. 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 Konstantu. Remove-Alias používá parametr Force k odebrání aliasů, včetně aliasů pouze pro čtení, ze session PowerShellu.

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

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Name

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

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:0
Povinné:True
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-Scope

Ovlivňuje pouze aliasy v zadaném oboru. Výchozí obor je místní. Další informace najdete v části 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ý)

Vlastnosti parametru

Typ:String
Default value:Local
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

String

Objekt aliasu můžete přesměrovat do Remove-Alias.

Výstupy

None

Tato rutina nevrací žá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 viz about_Aliases.