Megosztás a következőn keresztül:

Import-PowerShellDataFile

Modul:
Microsoft.PowerShell.Utility Module

Értékeket importál egy .psd1 fájlból a tartalmának meghívása nélkül.

Syntax

ByPath (Alapértelmezett) 

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

ByLiteralPath 

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

Description

A Import-PowerShellDataFile parancsmag biztonságosan importálja a kulcs-érték párokat egy .psd1 fájlban definiált kivonatolókból. Az értékek importálhatók a fájl tartalmára vonatkozó Invoke-Expression használatával. Azonban Invoke-Expression a fájlban található kódot futtatja. Ez nemkívánatos eredményeket eredményezhet, vagy nem biztonságos kódot futtathat. Import-PowerShellDataFile a kód meghívása nélkül importálja az adatokat. Alapértelmezés szerint 500-as kulcskorlát van érvényben, de ez megkerülhető a SkipLimitCheck kapcsolóval.

Példák

1. példa: Értékek lekérése a PSD1-ből

Ez a példa a Configuration.psd1 fájlban tárolt kivonatolóban tárolt kulcs-érték párokat kéri le. Get-Content a Configuration.psd1 fájl tartalmának megjelenítésére szolgál.

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

Paraméterek

-LiteralPath

Az importálandó fájl elérési útja. Az elérési út minden karaktere konstans értékként lesz kezelve. A helyettesítő karakterek feldolgozása nem történik meg.

Paramétertulajdonságok

Típus:

String[]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:PSPath, LP

Paraméterkészletek

ByLiteralPath
Position:0
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-Path

Az importálandó fájl elérési útja. A helyettesítő karakterek használata engedélyezett, de csak az első egyező fájl importálása történik.

Paramétertulajdonságok

Típus:

String[]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:True
DontShow:False

Paraméterkészletek

ByPath
Position:0
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-SkipLimitCheck

Alapértelmezés szerint Import-PowerShellDataFile csak 500 kulcsot importál egy .psd1 fájlból. Több mint 500 kulcs importálásához használja SkipLimitCheck.

Paramétertulajdonságok

Típus:Switch
Alapértelmezett érték:False
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

All
Position:0
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Kimenetek

Hashtable

Ez a parancsmag kivonattáblázatként adja vissza a fájlból származó adatokat.