Freigeben über

Import-PowerShellDataFile

Modul:
Microsoft.PowerShell.Utility Module

Importiert Werte aus einer .psd1 Datei, ohne den Inhalt aufzugeben.

Syntax

ByPath (Standardwert) 

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

ByLiteralPath 

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

Beschreibung

Das cmdlet Import-PowerShellDataFile importiert schlüsselwertpaare sicher aus Hashtables, die in einer .psd1 Datei definiert sind. Die Werte können mithilfe von Invoke-Expression für den Inhalt der Datei importiert werden. Invoke-Expression führt jedoch jeden Code aus, der in der Datei enthalten ist. Dies kann unerwünschte Ergebnisse erzeugen oder unsicheren Code ausführen. Import-PowerShellDataFile importiert die Daten ohne Aufrufen des Codes. Standardmäßig gibt es ein Limit von 500 Schlüsseln, dies kann jedoch mit dem Schalter SkipLimitCheck umgangen werden.

Beispiele

Beispiel 1: Abrufen von Werten aus PSD1

In diesem Beispiel werden die Schlüsselwertpaare abgerufen, die in der Hashtabelle gespeichert sind, die in der Configuration.psd1 Datei gespeichert ist. Get-Content wird verwendet, um den Inhalt der Configuration.psd1 Datei anzuzeigen.

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

Parameter

-LiteralPath

Der Pfad zu der Datei, die importiert wird. Alle Zeichen im Pfad werden als Literalwerte behandelt. Wildcardzeichen werden nicht verarbeitet.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:PSPath, EP

Parametersätze

ByLiteralPath
Position:0
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Path

Der Pfad zu der Datei, die importiert wird. Wildcards sind zulässig, aber nur die erste übereinstimmende Datei wird importiert.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:True
Nicht anzeigen:False

Parametersätze

ByPath
Position:0
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SkipLimitCheck

Standardmäßig importiert Import-PowerShellDataFile nur 500 Schlüssel aus einer .psd1 Datei. Verwenden Sie SkipLimitCheck-, um mehr als 500 Schlüssel zu importieren.

Parametereigenschaften

Typ:Switch
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

All
Position:0
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Ausgaben

Hashtable

Dieses Cmdlet gibt die Daten aus der Datei als Hashtabelle zurück.