about_Data_Files

Descrição curta

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 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 cmdlet Import-PowerShellDataFile importa arquivos de dados básicos. Os dados no arquivo devem estar contidos em um hashtable. Esse formato só dá suporte a valores constantes. Você não pode usar o código ou expressões do PowerShell.

Manifestos do módulo

Os manifestos do módulo são arquivos de dados do PowerShell. Os dados no arquivo devem estar contidos em um hashtable. A estrutura desse hashtable só dá suporte 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-Module, o manifesto é avaliado no modo de linguagem Restricted. Restricted modo limita os comandos e variáveis que podem ser usados.

Para obter mais informações, consulte about_Module_Manifests.

Dados localizados

O cmdlet Import-LocalizedData importa arquivos de dados localizados. Durante a importação, o arquivo é processado no modo de linguagem Constrained. Constrained 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 deveriam ser usados para armazenar dados de cadeia de caracteres que poderiam ser convertidos em 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 hashtables. Ele pode estar em qualquer formato compatível com a sintaxe do PowerShell, como seções de data.

Para obter mais informações, consulte about_Data_Sections.

Consulte também

• Import-LocalizedData
• import-module
• Import-PowerShellDataFile
• about_Data_Sections
• about_Language_Modes
• about_Module_Manifests