Udostępnij za pomocą

Remove-Alias

Moduł:
Microsoft.PowerShell.Utility Module

Usuń alias z bieżącej sesji.

Składnia

Default (Domyślna) 

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. Operator -ne (nie równa się) wybiera obiekty, które nie mają wartości Options 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.

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ązkowy: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ązkowy: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ązkowy: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

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.