Sdílet prostřednictvím

Remove-Alias

Modul:
Microsoft.PowerShell.Utility Module

Odeberte alias z aktuální relace.

Syntaxe

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. Operátor -ne (nerovná se) vybere objekty, které nemají hodnotu Možnosti nastavenou na hodnotu Konstantní. Remove-Alias používá parametr Force k odebrání aliasů, včetně aliasů pouze pro čtení, ze session 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 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 do této rutiny převést.

Výstupy

None

Tento cmdlet 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 viz about_Aliases.