Import-PowerShellDataFile

Module:
Microsoft.PowerShell.Utility Module

Importe des valeurs à partir d’un fichier .psd1 sans appeler son contenu.

Syntaxe

ByPath (Par défaut) 

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

ByLiteralPath 

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

Description

L’applet de commande Import-PowerShellDataFile importe en toute sécurité des paires clé-valeur à partir de tables de hachage définies dans un fichier .psd1. Les valeurs peuvent être importées à l’aide de Invoke-Expression sur le contenu du fichier. Toutefois, Invoke-Expression exécute tout code contenu dans le fichier. Cela peut produire des résultats indésirables ou exécuter du code non sécurisé. Import-PowerShellDataFile importe les données sans appeler le code.

Exemples

Exemple 1 : Récupérer des valeurs à partir de PSD1

Cet exemple récupère les paires clé-valeur stockées dans la table de hachage conservées dans le fichier Configuration.psd1. Get-Content est utilisé pour afficher le contenu du fichier Configuration.psd1.

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

Paramètres

-LiteralPath

Chemin d’accès au fichier en cours d’importation. Tous les caractères du chemin d’accès sont traités comme des valeurs littérales. Les caractères génériques ne sont pas traités.

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:PSPath, DP

Jeux de paramètres

ByLiteralPath
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Path

Chemin d’accès au fichier en cours d’importation. Les caractères génériques sont autorisés, mais seuls le premier fichier correspondant est importé.

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:True
DontShow:False

Jeux de paramètres

ByPath
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SkipLimitCheck

Par défaut Import-PowerShellDataFile , il est limité à 500 clés contenant un maximum de 5 000 nœuds AST lors de l’importation à partir d’un .psd1 fichier. Utilisez SkipLimitCheck pour contourner ces limites.

Important

Vous ne devez contourner les limites que si vous êtes sûr que le fichier est sûr d’être importé. Il est possible qu’un acteur malveillant crée un .psd1 fichier avec un grand nombre de clés ou de nœuds AST qui peuvent entraîner un déni de service.

Propriétés du paramètre

Type:Switch
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

All
Position:0
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Sorties

Hashtable

Cette applet de commande retourne les données du fichier sous forme de table de hachage.