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
To polecenie tworzy alias o nazwie C
do reprezentowania Get-ChildItem
polecenia cmdlet. Tworzy opis "szybkiego aliasu gci" dla aliasu i sprawia, że jest tylko do odczytu.
New-Alias -Name "C" -Value Get-ChildItem -Description "quick gci alias" -Option ReadOnly
Get-Alias -Name "C" | Format-List *
HelpUri : https://go.microsoft.com/fwlink/?LinkID=2096492
ResolvedCommandName : Get-ChildItem
DisplayName : C -> Get-ChildItem
ReferencedCommand : Get-ChildItem
ResolvedCommand : Get-ChildItem
Definition : Get-ChildItem
Options : ReadOnly
Description : quick gci alias
OutputType : {System.IO.FileInfo, System.IO.DirectoryInfo}
Name : C
CommandType : Alias
Source :
Version :
Visibility : Public
ModuleName :
Module :
RemotingCapability : PowerShell
Parameters : {[Path, System.Management.Automation.ParameterMetadata], [LiteralPath,
System.Management.Automation.ParameterMetadata], [Filter,
System.Management.Automation.ParameterMetadata], [Include,
System.Management.Automation.ParameterMetadata]…}
Polecenie Get-Alias
potokowe Format-List
wyświetla wszystkie informacje o nowym aliasie.
Przykład 3. Tworzenie aliasu dla polecenia z parametrami
function Set-ParentDirectory {Set-Location -Path ..}
New-Alias -Name .. -Value Set-ParentDirectory
Pierwsze polecenie tworzy funkcję Set-ParentDirectory
, która używa Set-Location
polecenia , aby ustawić lokalizację roboczą na katalog nadrzędny. Drugie polecenie używa New-Alias
polecenia do utworzenia aliasu ..
w celu wywołania Set-ParentDirectory
funkcji. Ponieważ parametr Value wymaga polecenia cmdlet, funkcji lub wartości wykonywalnej, należy utworzyć funkcję niestandardową, aby utworzyć alias używający parametrów. Uruchomienie aliasu ..
zmienia bieżącą lokalizację w katalogu nadrzędnym.
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.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania 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