Compartilhar via

Import-PowerShellDataFile

  • Referência
Módulo:
Microsoft.PowerShell.Utility

Importa valores de um .PSD1 arquivo sem chamar seu conteúdo.

Sintaxe

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

Description

O Import-PowerShellDataFile cmdlet importa com segurança pares de chave-valor de tabelas de hash definidas em um .PSD1 arquivo. Os valores podem ser importados usando Invoke-Expression o 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 do PSD1

Este exemplo recupera os pares de chave-valor armazenados na tabela de hash mantida dentro do Configuration.psd1 arquivo. Get-Content é usado para mostrar o conteúdo do Configuration.psd1 arquivo.

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.

Tipo:String[]
Aliases:PSPath, LP
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Path

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

Tipo:String[]
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:True

-SkipLimitCheck

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

Tipo:Switch
Cargo:0
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Saídas

Hashtable

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