Udostępnij za pośrednictwem

Import-Alias

  • Odwołanie
Moduł:
Microsoft.PowerShell.Utility

Importuje listę aliasów z pliku.

Składnia

Import-Alias
      [-Path] <String>
      [-Scope <String>]
      [-PassThru]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Import-Alias
      -LiteralPath <String>
      [-Scope <String>]
      [-PassThru]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Opis

Polecenie cmdlet Import-Alias importuje listę aliasów z pliku.

Począwszy od programu Windows PowerShell 3.0, jako funkcji zabezpieczeń, Import-Alias domyślnie nie zastępuje istniejących aliasów. Aby zastąpić istniejący alias, po zapewnieniu, że zawartość pliku aliasu jest bezpieczna, użyj parametru Force.

Przykłady

Przykład 1. Importowanie aliasów z pliku

Import-Alias test.txt

To polecenie importuje informacje o aliasie z pliku o nazwie test.txt.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Force

Umożliwia poleceniem cmdlet importowanie aliasu, który jest już zdefiniowany lub jest tylko do odczytu. Możesz użyć następującego polecenia, aby wyświetlić informacje o aktualnie zdefiniowanych aliasach:

Get-Alias | Select-Object Name, Options

Jeśli odpowiedni alias jest tylko do odczytu, zostanie wyświetlony w wartości właściwości Options.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-LiteralPath

Określa ścieżkę do pliku zawierającego wyeksportowane informacje o aliasie. W przeciwieństwie do parametru Path wartość parametru LiteralPath jest używana dokładnie tak, jak jest typowana. Znaki nie są interpretowane jako symbole wieloznaczne. Jeśli ścieżka zawiera znaki ucieczki, należy ująć ją w pojedynczy cudzysłów. Pojedyncze znaki cudzysłowu informują program PowerShell, aby nie interpretował żadnych znaków jako sekwencji ucieczki.

Typ:String
Aliasy:PSPath, LP
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-PassThru

Zwraca obiekt reprezentujący element, z którym pracujesz. Domyślnie to polecenie cmdlet nie generuje żadnych danych wyjściowych.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Path

Określa ścieżkę do pliku zawierającego wyeksportowane informacje o aliasie. Symbole wieloznaczne są dozwolone, ale muszą być rozpoznawane jako pojedyncza nazwa.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:True

-Scope

Określa zakres, do którego są importowane aliasy. Dopuszczalne wartości tego parametru to:

  • Globalny
  • Lokalny
  • Skrypt
  • Liczba względem bieżącego zakresu (od 0 do liczby zakresów, gdzie 0 jest bieżącym zakresem, a 1 jest jego elementem nadrzędnym)

Wartość domyślna to Local (Lokalny). Aby uzyskać więcej informacji, zobacz about_Scopes.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

Możesz potokować ciąg zawierający ścieżkę 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 alias.

Uwagi

Program PowerShell zawiera następujące aliasy dla Import-Alias:

  • Wszystkie platformy:
    • ipal