Delen via

Import-PowerShellDataFile

Module:
Microsoft.PowerShell.Utility Module

Hiermee importeert u waarden uit een .psd1 bestand zonder de inhoud ervan aan te roepen.

Syntaxis

ByPath (Standaard) 

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

ByLiteralPath 

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

Description

Met de Import-PowerShellDataFile cmdlet worden sleutel-waardeparen veilig geïmporteerd uit hashtabellen die zijn gedefinieerd in een .psd1-bestand. De waarden kunnen worden geïmporteerd met behulp van Invoke-Expression op de inhoud van het bestand. Invoke-Expression voert echter alle code in het bestand uit. Dit kan ongewenste resultaten opleveren of onveilige code uitvoeren. Import-PowerShellDataFile de gegevens importeert zonder de code aan te roepen. Standaard is er een limiet van 500 sleutels, maar dit kan worden overgeslagen met de SkipLimitCheck--switch.

Voorbeelden

Voorbeeld 1: Waarden ophalen uit PSD1

In dit voorbeeld worden de sleutel-waardeparen opgehaald die zijn opgeslagen in de hashtabel die in het Configuration.psd1-bestand worden bewaard. Get-Content wordt gebruikt om de inhoud van het Configuration.psd1 bestand weer te geven.

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

Parameters

-LiteralPath

Het pad naar het bestand dat wordt geïmporteerd. Alle karakters in het pad worden als letterlijke waarden behandeld. Jokertekens worden niet verwerkt.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:PSPath, LP

Parametersets

ByLiteralPath
Position:0
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Path

Het pad naar het bestand dat wordt geïmporteerd. Jokertekens zijn toegestaan, maar er wordt alleen het eerste overeenkomende bestand geïmporteerd.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:True
DontShow:False

Parametersets

ByPath
Position:0
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-SkipLimitCheck

Standaard importeert Import-PowerShellDataFile slechts 500 sleutels uit een .psd1 bestand. Gebruik SkipLimitCheck- om meer dan 500 sleutels te importeren.

Parametereigenschappen

Type:Switch
Default value:False
Ondersteunt jokertekens:False
DontShow:False

Parametersets

All
Position:0
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Uitvoerwaarden

Hashtable

Deze cmdlet retourneert de gegevens uit het bestand als een hash-tabel.