Partilhar via

Import-PowerShellDataFile

Módulo:
Microsoft.PowerShell.Utility Module

Importa valores de um arquivo .psd1 sem invocar seu conteúdo.

Sintaxe

ByPath (Predefinição) 

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

ByLiteralPath 

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

Description

O cmdlet Import-PowerShellDataFile importa com segurança pares chave-valor de hashtables definidos em um arquivo .psd1. Os valores podem ser importados usando Invoke-Expression no conteúdo do arquivo. No entanto, Invoke-Expression executa qualquer código contido no arquivo. Isso pode produzir resultados indesejados ou executar código inseguro. Import-PowerShellDataFile importa os dados sem invocar o código. Por padrão, há um limite de 500 chaves, mas isso pode ser ignorado com a opção SkipLimitCheck.

Exemplos

Exemplo 1: Recuperar valores de PSD1

Este exemplo recupera os pares chave-valor armazenados na hashtable mantida dentro do arquivo Configuration.psd1. Get-Content é usado para mostrar o conteúdo do arquivo 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

O caminho para o arquivo que está sendo importado. Todos os caracteres no caminho são tratados como valores literais. Os caracteres curinga não são processados.

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:PSPath, LP

Conjuntos de parâmetros

ByLiteralPath
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Path

O caminho para o arquivo que está sendo importado. Curingas são permitidos, mas apenas o primeiro arquivo correspondente é importado.

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:True
NãoMostrar:False

Conjuntos de parâmetros

ByPath
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-SkipLimitCheck

Por padrãoImport-PowerShellDataFile importa apenas 500 chaves de um arquivo .psd1. Use SkipLimitCheck para importar mais de 500 chaves.

Propriedades dos parâmetros

Tipo:Switch
Default value:False
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

All
Position:0
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Saídas

Hashtable

Este cmdlet retorna os dados do arquivo como uma tabela de hash.