Sdílet prostřednictvím

Import-PowerShellDataFile

Modul:
Microsoft.PowerShell.Utility Module

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

Syntax

ByPath (Výchozí) 

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

ByLiteralPath 

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

Description

Rutina Import-PowerShellDataFile bezpečně importuje páry klíč-hodnota z hashtables definovaných v souboru .psd1. Hodnoty lze importovat pomocí Invoke-Expression v obsahu souboru. Invoke-Expression ale spustí veškerý 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.

Poznámka:

Můžete importovat pouze prvních 500 párů klíč-hodnota.

Příklady

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

Tento příklad načte páry klíč-hodnota uložené v hashtable uložené uvnitř souboru Configuration.psd1. Get-Content slouží k zobrazení obsahu souboru 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

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

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:PSPath, PO

Sady parametrů

ByLiteralPath
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-Path

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

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:True
DontShow:False

Sady parametrů

ByPath
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Výstupy

Hashtable

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