Importar-PowerShellDataFile (Microsoft.PowerShell.Utility)

Importar-PowerShellDataFile

Módulo:

Microsoft.PowerShell.Utility

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

Sintaxis

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

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

Descripción

El cmdlet Import-PowerShellDataFile importa de forma segura pares clave-valor de tablas hash definidas en un archivo .PSD1. Los valores se pueden importar usando 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 inseguro. Import-PowerShellDataFile importa los datos sin invocar el código. De forma predeterminada, existe un límite de 500 claves, pero se puede omitir con el interruptor SkipLimitCheck.

Ejemplos

Ejemplo 1: recuperar valores de PSD1

Este ejemplo recupera los pares clave-valor almacenados en la tabla hash guardada dentro del archivo Configuration.psd1. Get-Content se utiliza para mostrar el contenido del archivo 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

Parámetros

-LiteralPath

La ruta al archivo que se está importando. Todos los caracteres de la ruta 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

La ruta al archivo que se está importando. Se permiten comodines, 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. Utilice SkipLimitCheck para importar más de 500 claves.

Tipo :

Cambiar

Posición:

0

Valor predeterminado:

False

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

Salidas

Tabla hash

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