Remove-Alias
Usuń alias z bieżącej sesji.
Składnia
Remove-Alias
[-Name] <String[]>
[-Scope <String>]
[-Force]
[<CommonParameters>]
Opis
Polecenie Remove-Alias
cmdlet usuwa alias z bieżącej sesji programu PowerShell. Aby usunąć alias z właściwością Option ustawioną na ReadOnly, użyj parametru Force .
Polecenie Remove-Alias
cmdlet zostało wprowadzone w programie PowerShell 6.0.
Przykłady
Przykład 1 — usuwanie aliasu
W tym przykładzie jest usuwany alias o nazwie del
, który reprezentuje Remove-Item
polecenie cmdlet.
Remove-Alias -Name del
Przykład 2 — usuwanie wszystkich aliasów innych niż stałe
W tym przykładzie wszystkie aliasy są usuwane z bieżącej sesji programu PowerShell, z wyjątkiem aliasów z właściwością Options ustawioną na Stałą. Po uruchomieniu polecenia aliasy są dostępne w innych sesjach programu PowerShell lub w nowych sesjach programu PowerShell.
Get-Alias | Where-Object { $_.Options -NE "Constant" } | Remove-Alias -Force
Get-Alias
Pobiera wszystkie aliasy w sesji programu PowerShell i wysyła obiekty w dół potoku.
Where-Object
używa bloku skryptu, a zmienna automatyczna ($_
) i właściwość Options reprezentują bieżący obiekt potoku. Parametr NE (nie jest równy), wybiera obiekty, które nie mają wartości Opcje ustawionej na Stała. Remove-Alias
Używa parametru Force , aby usunąć aliasy, w tym aliasy tylko do odczytu, z sesji programu PowerShell. Parametr Force nie może usunąć aliasów stałych .
Parametry
-Force
Wskazuje, że polecenie cmdlet usuwa alias, w tym aliasy z właściwością Option ustawioną na ReadOnly. Parametr Force nie może usunąć aliasu z właściwością Option ustawioną na Stałą.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Określa nazwę aliasu do usunięcia.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Scope
Wpływa tylko na aliasy w określonym zakresie. Domyślnym zakresem jest Lokalny. Aby uzyskać więcej informacji, zobacz about_Scopes.
Dopuszczalne wartości tego parametru to:
Global
Local
Script
- Liczba względem bieżącego zakresu (od 0 do liczby zakresów, gdzie 0 jest bieżącym zakresem, a 1 jest jego elementem nadrzędnym)
Type: | String |
Position: | Named |
Default value: | Local |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Dane wejściowe
String[]
Do tego polecenia cmdlet można przekazać obiekt aliasu.
Dane wyjściowe
None
To polecenie cmdlet nie zwraca żadnych danych wyjściowych.
Uwagi
Zmiany mają wpływ tylko na bieżący zakres. Aby usunąć alias ze wszystkich sesji, dodaj Remove-Alias
polecenie do profilu programu PowerShell.
Aby uzyskać więcej informacji, zobacz about_Aliases.
Linki powiązane
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla