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[]>
      [-SkipLimitCheck]
      [<CommonParameters>]
Import-PowerShellDataFile
      [-LiteralPath] <String[]>
      [-SkipLimitCheck]
      [<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. 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 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. Symbole wieloznaczne nie są przetwarzane.

Type:String[]
Aliases:PSPath, LP
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Path

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

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:True

-SkipLimitCheck

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

Type:Switch
Position:0
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Dane wyjściowe

Hashtable

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