Compartilhar via


about_Data_Files

Descrição breve

Os arquivos de dados do PowerShell são usados para armazenar dados arbitrários usando a sintaxe do PowerShell.

Descrição longa

Arquivos de dados do PowerShell (.psd1) podem armazenar dados arbitrários na sintaxe do PowerShell. Esses dados podem ser importados para variáveis em uma sessão do PowerShell. O PowerShell tem três tipos de arquivos de dados e fornece um cmdlet para importar cada tipo.

Arquivos de dados básicos

O Import-PowerShellDataFile cmdlet importa arquivos de dados básicos. Os dados no arquivo devem estar contidos em uma tabela de hash. Esse formato dá suporte apenas a valores constantes. Você não pode usar código ou expressões do PowerShell.

Manifestos do módulo

Manifestos de módulo são arquivos de dados do PowerShell. Os dados no arquivo devem estar contidos em uma tabela de hash. A estrutura dessa tabela de hash dá suporte apenas a nomes de chave específicos relacionados a módulos do PowerShell.

Os valores atribuídos às configurações no arquivo de manifesto podem ser expressões avaliadas pelo PowerShell. Isso permite que você construa caminhos e atribua valores condicionalmente com base em variáveis.

Quando você importa um módulo usando Import-Module, o manifesto é avaliado no Restricted modo de linguagem. Restricted mode limita os comandos e variáveis que podem ser usados.

Para obter mais informações, consulte about_Module_Manifests.

Dados localizados

O Import-LocalizedData cmdlet importa arquivos de dados localizados. Durante a importação, o arquivo é processado no Constrained modo de linguagem. Constrained mode limita os comandos e variáveis que podem ser usados.

Para obter mais informações, consulte about_Language_Modes.

Originalmente, os arquivos de dados localizados deveriam ser usados para armazenar dados de cadeia de caracteres que poderiam ser traduzidos para outros idiomas. Isso permitiu que seus scripts importassem os dados para fornecer saída de cadeia de caracteres localizada em outros idiomas. No entanto, você não está limitado a armazenar dados de cadeia de caracteres e não precisa usar os dados para saída localizada.

Os dados no arquivo não se limitam a tabelas de hash. Ele pode estar em qualquer formato compatível com a sintaxe do PowerShell, como DATA seções.

Para obter mais informações, consulte about_Data_Sections.

Confira também