Import-PowerShellDataFile
Importiert Werte aus einer .PSD1
Datei, ohne deren Inhalt zu aufrufen.
Syntax
Import-PowerShellDataFile
[-Path] <String[]>
[-SkipLimitCheck]
[<CommonParameters>]
Import-PowerShellDataFile
[-LiteralPath] <String[]>
[-SkipLimitCheck]
[<CommonParameters>]
Beschreibung
Das Import-PowerShellDataFile
Cmdlet importiert Schlüssel-Wert-Paare sicher aus Hashtabellen, die in einer .PSD1
Datei definiert sind. Die Werte können mit Invoke-Expression
für den Inhalt der Datei importiert werden.
Führt jedoch jeden code aus, Invoke-Expression
der in der Datei enthalten ist. Dies kann zu unerwünschten Ergebnissen führen oder unsicheren Code ausführen. Import-PowerShellDataFile
importiert die Daten, ohne den Code zu aufrufen. Standardmäßig gilt ein Schlüssellimit von 500, dies kann jedoch mit dem SkipLimitCheck-Schalter umgangen werden.
Beispiele
Beispiel 1: Abrufen von Werten aus PSD1
In diesem Beispiel werden die Schlüssel-Wert-Paare abgerufen, die in der Hashtabelle in der Configuration.psd1
Datei gespeichert sind. 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 zu importierenden Datei. Alle Zeichen im Pfad werden als Literalwerte behandelt. Wildcardzeichen 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 zu importierenden Datei. Wildcards sind zulässig, aber es wird nur die erste übereinstimmende Datei importiert.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-SkipLimitCheck
Standardmäßig Import-PowerShellDataFile
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
Dieses Cmdlet gibt die Daten aus der Datei als Hashtabelle zurück.