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 Force
  • Constant: Nie można usunąć ani zmienić aliasu
  • Private: Alias jest dostępny tylko w bieżącym zakresie
  • AllScope: Alias jest kopiowany do wszystkich nowych utworzonych zakresów
  • Unspecified: 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 i 1 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.

AliasInfo

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 lub New-Alias. Aby zmienić alias, użyj polecenia Set-Alias. Aby usunąć alias, użyj polecenia Remove-Alias.