Condividi tramite

Import-PowerShellDataFile

Modulo:
Microsoft.PowerShell.Utility Module

Importa i valori da un file .psd1 senza richiamarne il contenuto.

Sintassi

ByPath (Impostazione predefinita) 

Import-PowerShellDataFile
    [[-Path] <string[]>]
    [<CommonParameters>]

ByLiteralPath 

Import-PowerShellDataFile
    [-LiteralPath <string[]>]
    [<CommonParameters>]

Descrizione

Il cmdlet Import-PowerShellDataFile importa in modo sicuro coppie chiave-valore da tabelle hash definite in un file .psd1. È possibile importare i valori usando Invoke-Expression sul contenuto del file. Tuttavia, Invoke-Expression esegue qualsiasi codice contenuto nel file. Ciò potrebbe produrre risultati indesiderati o eseguire codice non sicuro. Import-PowerShellDataFile importa i dati senza richiamare il codice.

Annotazioni

È possibile importare solo le prime 500 coppie chiave-valore.

Esempio

Esempio 1: Recuperare i valori da PSD1

In questo esempio vengono recuperate le coppie chiave-valore archiviate nella tabella hash memorizzate all'interno del file Configuration.psd1. Get-Content viene usato per visualizzare il contenuto del file di 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

Parametri

-LiteralPath

Percorso del file da importare. Tutti i caratteri nel percorso vengono considerati come valori letterali.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:PSPath, UP

Set di parametri

ByLiteralPath
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Path

Percorso del file da importare. I caratteri jolly sono consentiti, ma viene importato solo il primo file corrispondente.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:True
DontShow:False

Set di parametri

ByPath
Posizione:0
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Output

Hashtable

Questo cmdlet restituisce i dati del file come tabella hash.