Import-PowerShellDataFile
Importa valores de um .PSD1
arquivo sem invocar seu conteúdo.
Syntax
Import-PowerShellDataFile
[-Path] <String[]>
[-SkipLimitCheck]
[<CommonParameters>]
Import-PowerShellDataFile
[-LiteralPath] <String[]>
[-SkipLimitCheck]
[<CommonParameters>]
Description
O Import-PowerShellDataFile
cmdlet importa com segurança pares chave-valor de tabelas de hash definidas em um .PSD1
arquivo. 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. 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 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.
Type: | String[] |
Aliases: | PSPath, LP |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Path
O caminho para o arquivo que está sendo importado. Curingas são permitidos, mas apenas o primeiro arquivo correspondente é importado.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-SkipLimitCheck
Por padrão Import-PowerShellDataFile
, importa apenas 500 chaves de um .psd1
arquivo. Use SkipLimitCheck para importar mais de 500 chaves.
Type: | Switch |
Position: | 0 |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Saídas
Esse cmdlet retorna os dados do arquivo como uma tabela de hash.
Links Relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de