Share 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

Os arquivos de dados (.psd1) do PowerShell 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 oferece suporte apenas a valores constantes. Não é possível usar expressões de código ou PowerShell.

Manifestos do módulo

Os 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 hashtable oferece suporte apenas a nomes de chave específicos relacionados aos 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-Moduleo , o manifesto é avaliado no Restricted modo de idioma. Restricted O modo 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 idioma. Constrained O modo 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 foram feitos para serem usados para armazenar dados de cadeia de caracteres que poderiam ser traduzidos para outros idiomas. Isso permitiu que os 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 estão limitados a hashtables. Ele pode estar em qualquer formato suportado pela sintaxe do PowerShell, como DATA seções.

Para obter mais informações, consulte about_Data_Sections.

Confira também