Sdílet prostřednictvím

Import-PowerShellDataFile

  • Reference
Modul:
Microsoft.PowerShell.Utility

Importuje hodnoty ze .PSD1 souboru bez vyvolání jeho obsahu.

Syntaxe

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

Description

Rutina Import-PowerShellDataFile bezpečně importuje páry klíč-hodnota z hashtables definovaných v .PSD1 souboru. Hodnoty lze importovat pomocí Invoke-Expression obsahu souboru. Invoke-Expression Spustí ale jakýkoli kód obsažený v souboru. To může vést k nežádoucím výsledkům nebo spuštění nebezpečného kódu. Import-PowerShellDataFile importuje data bez vyvolání kódu. Ve výchozím nastavení existuje limit 500 klíčů, ale můžete ho obejít přepínačem SkipLimitCheck .

Příklady

Příklad 1: Načtení hodnot z PSD1

Tento příklad načte páry klíč-hodnota uložené v hashovatelné tabulce uložené uvnitř Configuration.psd1 souboru. Get-Content slouží k zobrazení obsahu Configuration.psd1 souboru.

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

Cesta k importovanému souboru. Všechny znaky v cestě jsou považovány za literální hodnoty. Zástupné znaky se nezpracují.

Typ:String[]
Aliasy:PSPath, LP
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Path

Cesta k importovanému souboru. Zástupné cardy jsou povolené, ale importuje se pouze první odpovídající soubor.

Typ:String[]
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:True

-SkipLimitCheck

Ve výchozím nastavení Import-PowerShellDataFile importuje ze .psd1 souboru pouze 500 klíčů. K importu více než 500 klíčů použijte SkipLimitCheck .

Typ:Switch
Position:0
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Výstupy

Hashtable

Tato rutina vrátí data ze souboru jako tabulku hash.