Leer en inglés

Compartir a través de

Import-PowerShellDataFile

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Importa valores de un archivo .PSD1 sin invocar su contenido.

Sintaxis

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

Description

El cmdlet Import-PowerShellDataFile importa de forma segura pares clave-valor de tablas hash definidas en un archivo .PSD1. Los valores se pueden importar mediante Invoke-Expression en el contenido del archivo. Sin embargo, Invoke-Expression ejecuta cualquier código contenido en el archivo. Esto podría producir resultados no deseados o ejecutar código no seguro. Import-PowerShellDataFile importa los datos sin invocar el código. De forma predeterminada, hay un límite de 500 claves, pero esto se puede omitir con el modificador de SkipLimitCheck.

Ejemplos

Ejemplo 1: Recuperar valores de PSD1

En este ejemplo se recuperan los pares clave-valor almacenados en la tabla hash que se mantiene dentro del archivo Configuration.psd1. Get-Content se usa para mostrar el contenido del archivo Configuration.psd1.

PowerShell 
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

Parámetros

-LiteralPath

Ruta de acceso al archivo que se va a importar. Todos los caracteres de la ruta de acceso se tratan como valores literales. Los caracteres comodín no se procesan.

Tipo:String[]
Alias:PSPath, LP
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Path

Ruta de acceso al archivo que se va a importar. Se permiten caracteres comodín, pero solo se importa el primer archivo coincidente.

Tipo:String[]
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:True

-SkipLimitCheck

De forma predeterminada, Import-PowerShellDataFile importa solo 500 claves de un archivo .psd1. Use SkipLimitCheck para importar más de 500 claves.

Tipo:Switch
Posición:0
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Salidas

Hashtable

Este cmdlet devuelve los datos del archivo como una tabla hash.