New-Alias
Tworzy nowy alias.
Składnia
New-Alias
[-Name] <String>
[-Value] <String>
[-Description <String>]
[-Option <ScopedItemOptions>]
[-PassThru]
[-Scope <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Opis
Polecenie New-Alias
cmdlet tworzy nowy alias w bieżącej sesji programu PowerShell. Aliasy utworzone za pomocą polecenia New-Alias
nie są zapisywane po zakończeniu sesji lub zamknięciu programu PowerShell.
Możesz użyć Export-Alias
polecenia cmdlet , aby zapisać informacje o aliasie w pliku. Później możesz użyć Import-Alias
polecenia , aby pobrać zapisane informacje o aliasie.
Przykłady
Przykład 1. Tworzenie aliasu dla polecenia cmdlet
New-Alias -Name "List" Get-ChildItem
To polecenie tworzy alias o nazwie List reprezentujący polecenie cmdlet Get-ChildItem.
Przykład 2. Tworzenie aliasu tylko do odczytu dla polecenia cmdlet
New-Alias -Name "C" -Value Get-ChildItem -Description "quick gci alias" -Option ReadOnly
Get-Alias -Name "C" | Format-List *
To polecenie tworzy alias o nazwie C
do reprezentowania Get-ChildItem
polecenia cmdlet. Tworzy opis , dla aliasu i sprawia, quick gci alias
że jest tylko do odczytu. Ostatni wiersz polecenia używa Get-Alias
polecenia w celu pobrania nowego aliasu i potoku go do pozycji Format-List, aby wyświetlić wszystkie informacje o nim.
Parametry
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Określa opis aliasu. Możesz wpisać dowolny ciąg. Jeśli opis zawiera spacje, należy go ująć w cudzysłów.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Wskazuje, że polecenie cmdlet działa tak, jakby Set-Alias
alias o nazwie już istnieje.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Określa nowy alias. Można użyć dowolnych znaków alfanumerycznych w aliasie, ale pierwszy znak nie może być liczbą.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Option
Określa wartość właściwości Options aliasu. Prawidłowe wartości to:
None
: Alias nie ma ograniczeń (wartość domyślna)ReadOnly
: Alias można usunąć, ale nie można go zmienić z wyjątkiem przy użyciu parametru ForceConstant
: Nie można usunąć ani zmienić aliasuPrivate
: Alias jest dostępny tylko w bieżącym zakresieAllScope
: Alias jest kopiowany do wszystkich nowych utworzonych zakresówUnspecified
: Nie określono opcji
Te wartości są definiowane jako wyliczenie oparte na flagach. Możesz połączyć wiele wartości ze sobą, aby ustawić wiele flag przy użyciu tego parametru. Wartości można przekazać do parametru Option jako tablicę wartości lub jako ciąg rozdzielany przecinkami tych wartości. Polecenie cmdlet połączy wartości przy użyciu operacji binary-OR. Przekazywanie wartości jako tablicy jest najprostszą opcją, a także umożliwia użycie uzupełniania tabulatorów na wartościach.
Aby wyświetlić właściwość Options wszystkich aliasów w sesji, wpisz Get-Alias | Format-Table -Property Name, Options -AutoSize
.
Type: | ScopedItemOptions |
Accepted values: | None, ReadOnly, Constant, Private, AllScope, Unspecified |
Position: | Named |
Default value: | [System.Management.Automation.ScopedItemOptions]::None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Zwraca obiekt reprezentujący element, z którym pracujesz. Domyślnie to polecenie cmdlet nie generuje żadnych danych wyjściowych.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Scope
Określa zakres nowego aliasu. 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 i1
jest jego elementem nadrzędnym).
Wartość domyślna to Local
. Aby uzyskać więcej informacji, zobacz about_Scopes.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Value
Określa nazwę polecenia cmdlet lub elementu polecenia, który jest aliasowany.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Dane wejściowe
None
Nie można potokować obiektów do tego polecenia cmdlet.
Dane wyjściowe
None
Domyślnie to polecenie cmdlet nie zwraca żadnych danych wyjściowych.
Jeśli używasz parametru PassThru , to polecenie cmdlet zwraca obiekt AliasInfo reprezentujący nowy alias.
Uwagi
Program PowerShell zawiera następujące aliasy dla programu New-Alias
:
Wszystkie platformy:
nal
Aby utworzyć nowy alias, użyj polecenia
Set-Alias
lubNew-Alias
. Aby zmienić alias, użyj poleceniaSet-Alias
. Aby usunąć alias, użyj poleceniaRemove-Alias
.
Linki powiązane
Opinia
https://aka.ms/ContentUserFeedback.
Już wkrótce: w ciągu 2024 r. będziemy stopniowo usuwać problemy z usługą GitHub jako mechanizm opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla