Partager via

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[]>]
    [<CommonParameters>]

ByLiteralPath 

Import-PowerShellDataFile
    [-LiteralPath <string[]>]
    [<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.

Remarque

Vous ne pouvez importer que les 500 premières paires clé-valeur.

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.

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:Named
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

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.