Udostępnij przez

Remove-Alias

Moduł:
Microsoft.PowerShell.Utility Module

Usuń alias z bieżącej sesji.

Składnia

Default (domyślnie) 

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

Opis

Polecenie cmdlet Remove-Alias 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 cmdlet Remove-Alias zostało wprowadzone w programie PowerShell 6.0.

Przykłady

Przykład 1 — usuwanie aliasu

W tym przykładzie usunięto alias o nazwie del, który reprezentuje polecenie cmdlet Remove-Item.

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 wartość Stała. 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 Opcje właściwość reprezentuje bieżący obiekt potoku. Parametr NE (nie równa się), wybiera obiekty, które nie mają wartości opcji ustawioną na wartość Stała. Remove-Alias używa parametru Force, aby usunąć aliasy, w tym aliasy tylko do odczytu, z sesji programu PowerShell.

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 wartość Stała.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Name

Określa nazwę aliasu do usunięcia.

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:0
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-Scope

Wpływa tylko na aliasy w określonym zakresie. Domyślnym zakresem jest local . 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 zakresem nadrzędnym)

Właściwości parametru

Typ:String
Domyślna wartość:Local
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

String

Obiekt aliasu można przesyłać potokiem do Remove-Alias.

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 polecenie Remove-Alias do profilu programu PowerShell.

Aby uzyskać więcej informacji, zobacz about_Aliases.