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 Import-Alias cmdlet 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
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:

  • Globalnie
  • 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 po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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 Windows PowerShell zawiera następujące aliasy dla programu Import-Alias:

  • ipal