Udostępnij za pomocą

Import-PowerShellDataFile

Moduł:
Microsoft.PowerShell.Utility Module

Importuje wartości z pliku .psd1 bez wywoływania jego zawartości.

Składnia

ByPath (Domyślna) 

Import-PowerShellDataFile
    [-Path] <String[]>
    [-SkipLimitCheck]
    [<CommonParameters>]

ByLiteralPath 

Import-PowerShellDataFile
    [-LiteralPath] <String[]>
    [-SkipLimitCheck]
    [<CommonParameters>]

Opis

Polecenie cmdlet Import-PowerShellDataFile bezpiecznie importuje pary klucz-wartość z tabel skrótów zdefiniowanych w pliku .psd1. Wartości można zaimportować przy użyciu Invoke-Expression zawartości pliku. Jednak Invoke-Expression uruchamia dowolny kod zawarty w pliku. Może to spowodować niepożądane wyniki lub wykonać niebezpieczny kod. Import-PowerShellDataFile importuje dane bez wywoływania kodu. Domyślnie istnieje limit 500 kluczy, ale można go pominąć za pomocą przełącznika SkipLimitCheck.

Przykłady

Przykład 1. Pobieranie wartości z PSD1

W tym przykładzie są pobierane pary klucz-wartość przechowywane w tabeli skrótów przechowywane w pliku Configuration.psd1. Get-Content służy do wyświetlania zawartości pliku Configuration.psd1.

Get-Content .\Configuration.psd1
$config = Import-PowerShellDataFile .\Configuration.psd1
$config.AllNodes

@{
    AllNodes = @(
        @{
            NodeName = 'DSC-01'
        }
        @{
            NodeName = 'DSC-02'
        }
    )
}

Name                           Value
----                           -----
NodeName                       DSC-01
NodeName                       DSC-02

Parametry

-LiteralPath

Ścieżka do importowanego pliku. Wszystkie znaki w ścieżce są traktowane jako wartości literału. Symbole wieloznaczne nie są przetwarzane.

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:PSPath, LP

Zestawy parametrów

ByLiteralPath
Position:0
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-Path

Ścieżka do importowanego pliku. Symbole wieloznaczne są dozwolone, ale importowany jest tylko pierwszy pasujący plik.

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:True
DontShow:False

Zestawy parametrów

ByPath
Position:0
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-SkipLimitCheck

Domyślnie Import-PowerShellDataFile importuje tylko 500 kluczy z pliku .psd1. Aby zaimportować więcej niż 500 kluczy, użyj SkipLimitCheck.

Właściwości parametru

Typ:Switch
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

All
Position:0
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wyjściowe

Hashtable

To polecenie cmdlet zwraca dane z pliku jako tabelę skrótów.