Remove-Alias
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.
Související odkazy
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro