Udostępnij przez

Remove-Alias

Moduł:
Microsoft.PowerShell.Utility Module

Usuń alias z bieżącej sesji.

Składnia

Default (Domyślne) 

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 skryptblock, a właściwość automatyczna ($_) i Options reprezentują 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 parametrów

Typ:SwitchParameter
Wartość domyślna:False
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

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

-Name

Określa nazwę aliasu do usunięcia.

Właściwości parametrów

Typ:

String[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:0
Obowiązkowy:True
Wartość z pipeline:True
Wartość z pipeline według nazwy właściwości:True
Wartość 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 parametrów

Typ:String
Wartość domyślna:Local
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość 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.

Wejścia

String

Do tego polecenia cmdlet można przekazać obiekt aliasu.

Wyjść

None

To polecenie cmdlet nie zwraca żadnych danych wyjściowych.

Notatki

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.