Condividi tramite

Import-PowerShellDataFile

  • Riferimento
Modulo:
Microsoft.PowerShell.Utility

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

Sintassi

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

Descrizione

Il Import-PowerShellDataFile cmdlet importa in modo sicuro coppie chiave-valore da tabelle hash definite in un .PSD1 file. È possibile importare i valori usando Invoke-Expression nel 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. Per impostazione predefinita è previsto un limite di 500 chiavi, ma può essere ignorato con l'opzione SkipLimitCheck .

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 Configuration.psd1 file. Get-Content viene utilizzato per visualizzare il contenuto del Configuration.psd1 file.

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. I caratteri jolly non vengono elaborati.

Tipo:String[]
Alias:PSPath, LP
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Path

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

Tipo:String[]
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

-SkipLimitCheck

Per impostazione predefinita Import-PowerShellDataFile , importa solo 500 chiavi da un .psd1 file. Usare SkipLimitCheck per importare più di 500 chiavi.

Tipo:Switch
Posizione:0
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Output

Hashtable

Questo cmdlet restituisce i dati del file come tabella hash.