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 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. Parametr Force nie może usunąć aliasów stałej.

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.

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

Aby uzyskać więcej informacji, zobacz about_Aliases.