Import-PowerShellDataFile

  • Referenz
Modul:
Microsoft.PowerShell.Utility

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

Syntax

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

Beschreibung

Das Import-PowerShellDataFile Cmdlet importiert schlüsselwertbasierte Paare sicher aus Hashtables, die in einer .PSD1 Datei definiert sind. Die Werte können mithilfe Invoke-Expression des Inhalts der Datei importiert werden. Führt jedoch jeden Code aus, Invoke-Expression 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 SkipLimitCheck-Schalter 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. Wild Karte Zeichen werden nicht verarbeitet.

Type:String[]
Aliases:PSPath, LP
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Path

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

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:True

-SkipLimitCheck

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

Type:Switch
Position:0
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Ausgaben

Hashtable

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