Udostępnij za pośrednictwem

Remove-Alias

  • Odwołanie
Moduł:
Microsoft.PowerShell.Utility

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łą.

Typ:SwitchParameter
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwę aliasu do usunięcia.

Typ:String[]
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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)
Typ:String
Position:Named
Domyślna wartość:Local
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.