Import-PowerShellDataFile

Módulo:
Microsoft.PowerShell.Utility Module

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

Sintaxe

ByPath (Default) 

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 não seguro. Import-PowerShellDataFile importa os dados sem invocar o código.

Exemplos

Exemplo 1: recuperar valores do PSD1

Este exemplo recupera os pares chave-valor armazenados no hashtable mantido 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. Caracteres curinga não são processados.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:PSPath, LP

Conjuntos de parâmetros

ByLiteralPath
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Path

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

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:True
DontShow:False

Conjuntos de parâmetros

ByPath
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SkipLimitCheck

Por padrão Import-PowerShellDataFile , é limitado a 500 chaves que contêm um máximo de 5.000 nós AST ao importar de um .psd1 arquivo. Use SkipLimitCheck para ignorar esses limites.

Importante

Você só deve ignorar os limites se tiver certeza de que o arquivo é seguro de importar. É possível que um ator mal-intencionado crie um .psd1 arquivo com um grande número de chaves ou nós AST que possam resultar em uma negação de serviço.

Propriedades do parâmetro

Tipo:Switch
Valor padrão:False
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

All
Cargo:0
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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

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