Import-Alias
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 wersji Windows PowerShell 3.0, jako funkcji zabezpieczeń, Import-Alias
nie zastępuje domyślnie 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 aliasu z pliku o nazwie test.txt.
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 |
-Force
Umożliwia poleceniem cmdlet importowanie aliasu, który jest już zdefiniowany lub jest tylko do odczytu. Aby wyświetlić informacje o aktualnie zdefiniowanych aliasach, można użyć następującego polecenia:
Get-Alias | Select-Object Name, Options
Jeśli odpowiedni alias jest tylko do odczytu, zostanie wyświetlony w wartości właściwości Opcje .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LiteralPath
Określa ścieżkę do pliku, który zawiera 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 znaki pojedynczego cudzysłowu. Znaki pojedynczego cudzysłowu informują program PowerShell, aby nie interpretował żadnych znaków jako sekwencji ucieczki.
Type: | String |
Aliases: | PSPath, LP |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PassThru
Zwraca obiekt reprezentujący element, z którym pracujesz. Domyślnie to polecenie cmdlet nie generuje żadnego wyniku.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Określa ścieżkę do pliku, który zawiera wyeksportowane informacje o aliasie. Symbole wieloznaczne są dozwolone, ale muszą być rozpoznawane jako pojedyncza nazwa.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Scope
Określa zakres, do którego są importowane aliasy. Dopuszczalne wartości dla tego parametru to:
- Globalnie
- Lokalne
- 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 Lokalne. 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 |
-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
Możesz potokować ciąg zawierający ścieżkę do Import-Alias
.
Dane wyjściowe
None or System.Management.Automation.AliasInfo
W przypadku użycia parametru Import-Alias
Passthru zwraca obiekt System.Management.Automation.AliasInfo reprezentujący alias.
W przeciwnym razie to polecenie cmdlet nie generuje żadnych danych wyjściowych.