Udostępnij za pośrednictwem

Import-PowerShellDataFile

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

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

Składnia

Import-PowerShellDataFile
      [[-Path] <string[]>]
      [<CommonParameters>]
Import-PowerShellDataFile
      [-LiteralPath <string[]>]
      [<CommonParameters>]

Opis

Polecenie Import-PowerShellDataFile cmdlet bezpiecznie importuje pary klucz-wartość z tabel skrótów zdefiniowanych w .PSD1 pliku. 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.

Uwaga

Można zaimportować tylko pierwsze 500 par klucz-wartość.

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 Configuration.psd1 przechowywane wewnątrz pliku. Get-Content służy do wyświetlania zawartości Configuration.psd1 pliku.

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.

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

-Path

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

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

Dane wyjściowe

Hashtable

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