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.

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 Import-PowerShellDataFile är begränsat till 500 nycklar som innehåller högst 5 000 AST-noder vid import från en .psd1 fil. Använd SkipLimitCheck för att kringgå dessa gränser.

Viktigt!

Du bör bara kringgå gränserna om du är säker på att filen är säker att importera. Det är möjligt för en illasinnad aktör att skapa en .psd1 fil med ett stort antal nycklar eller AST-noder som kan leda till överbelastning.

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.