Dela via

Import-PowerShellDataFile

Modul:
Microsoft.PowerShell.Utility Module

Importerar värden från en .psd1 fil utan att anropa dess innehåll.

Syntax

ByPath (Standard) 

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

ByLiteralPath 

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

Description

Cmdleten Import-PowerShellDataFile importerar nyckel/värde-par från hashtables som definierats i en .psd1 fil. Värdena kan importeras med hjälp av Invoke-Expression på innehållet i filen. Men Invoke-Expression kör all kod som finns i filen. Detta kan ge oönskade resultat eller köra osäker kod. Import-PowerShellDataFile importerar data utan att anropa koden. Som standard finns det en gräns på 500 nycklar, men detta kan kringgås med SkipLimitCheck switch.

Exempel

Exempel 1: Hämta värden från PSD1

Det här exemplet hämtar nyckel/värde-paren som lagras i hashtable-filen som lagras i filen Configuration.psd1. Get-Content används för att visa innehållet i Configuration.psd1-filen.

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

Parametrar

-LiteralPath

Sökvägen till filen som importeras. Alla tecken i sökvägen behandlas som literalvärden. Jokertecken bearbetas inte.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:PSPath, SP

Parameteruppsättningar

ByLiteralPath
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Path

Sökvägen till filen som importeras. Jokertecken tillåts men endast den första matchande filen importeras.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:True
DontShow:False

Parameteruppsättningar

ByPath
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-SkipLimitCheck

Som standard importerar Import-PowerShellDataFile endast 500 nycklar från en .psd1 fil. Använd SkipLimitCheck för att importera fler än 500 nycklar.

Parameteregenskaper

Typ:Switch
Standardvärde:False
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

All
Position:0
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Utdata

Hashtable

Den här cmdleten returnerar data från filen som en hash-tabell.