Import-PowerShellDataFile

Módulo:
Microsoft.PowerShell.Utility Module

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

Sintaxis

ByPath (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.

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 de 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
Obligatorio: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 de parámetro

Tipo:

String[]

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

Conjuntos de parámetros

ByPath
Posición:0
Obligatorio: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 , se limita a 500 claves que contienen un máximo de 5000 nodos AST al importar desde un .psd1 archivo. Use SkipLimitCheck para omitir estos límites.

Importante

Solo debe omitir los límites si está seguro de que el archivo es seguro de importar. Es posible que un actor malintencionado cree un .psd1 archivo con un gran número de claves o nodos de AST que podrían dar lugar a una denegación de servicio.

Propiedades de parámetro

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

Conjuntos de parámetros

All
Posición:0
Obligatorio: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.