Compartir vía

Import-PowerShellDataFile

Módulo:
Microsoft.PowerShell.Utility Module

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

Sintaxis

ByPath (Es el valor predeterminado). 

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

ByLiteralPath 

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.

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.

Propiedades del parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:PSPath, LP

Conjuntos de parámetros

ByLiteralPath
Posición:0
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:True
DontShow:False

Conjuntos de parámetros

ByPath
Posición:0
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SkipLimitCheck

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

Propiedades del parámetro

Tipo:Switch
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

All
Posición:0
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Salidas

Hashtable

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