Partilhar via

about_Data_Sections

Breve descrição

Explica as seções data, que isolam as cadeias de texto e outros dados de leitura única da lógica do script.

Descrição longa

Os scripts projetados para o PowerShell podem ter uma ou mais seções data que contêm apenas dados. Você pode incluir uma ou mais seções data em qualquer script, função ou função avançada. O conteúdo da seção data é restrito a um subconjunto especificado da linguagem de script do PowerShell.

Separar dados da lógica de código torna mais fácil identificar e gerenciar lógica e dados. Ele permite que você tenha arquivos de recursos de cadeia de caracteres separados para texto, como mensagens de erro e cadeias de caracteres de Ajuda. Ele também isola a lógica do código, o que facilita os testes de segurança e validação.

No PowerShell, você pode usar a seção data para dar suporte à internacionalização de scripts. Você pode usar as seções data para facilitar o isolamento, localização e processamento de cadeias que podem ser traduzidas para outros idiomas.

A seção data foi adicionada ao recurso PowerShell 2.0.

Sintaxe

A sintaxe de uma seção data é a seguinte:

data [<variable-name>] [-SupportedCommand <cmdlet-name>] {
    <Permitted content>
}

A palavra-chave data é necessária. Não é sensível a maiúsculas e minúsculas. O conteúdo permitido está limitado aos seguintes elementos:

  • Todos os operadores do PowerShell, exceto -match

  • if, else, e elseif declarações

  • As seguintes variáveis automáticas: $PSCulture, $PSUICulture, $true, $false, e $null

  • Comentários

  • Pipelines

  • Instruções separadas por ponto-e-vírgula (;)

  • Literais, como os seguintes:

    a
1
1,2,3
"PowerShell 2.0"
@( "red", "green", "blue" )
@{ a = 0x1; b = "great"; c ="script" }
@'
<p> Hello, World </p>
'@

  • Cmdlets que são permitidos em uma data seção por padrão. Por padrão, apenas o ConvertFrom-StringData cmdlet é permitido.

  • Cmdlets que você permite em uma seção data usando o parâmetro -SupportedCommand.

Ao usar o cmdlet ConvertFrom-StringData numa seção data, pode incluir os pares chave-valor em cadeias de caracteres entre aspas simples ou duplas ou em here-strings entre aspas simples ou duplas. No entanto, as cadeias de caracteres que contêm variáveis e subexpressões devem ser incluídas em cadeias de caracteres entre aspas simples ou em cadeias de caracteres entre aspas simples para que as variáveis não sejam expandidas e as subexpressões não sejam executáveis.

-SupportedCommand

O parâmetro SupportedCommand permite indicar que um cmdlet ou função gera apenas dados. Ele foi concebido para permitir que os utilizadores incluam cmdlets e funções numa secção data que eles escreveram ou testaram.

O valor de SupportedCommand é uma lista separada por vírgulas de um ou mais nomes de cmdlets ou funções.

Por exemplo, a seção data a seguir inclui um cmdlet escrito pelo usuário, Format-Xml, que formata dados em um arquivo XML:

data -SupportedCommand Format-Xml
{
    Format-Xml -Strings string1, string2, string3
}

Utilizar uma secção data

Para usar o conteúdo de uma seção data, atribua-o a uma variável e use notação variável para acessar o conteúdo.

Por exemplo, a seção data a seguir contém um comando ConvertFrom-StringData que converte a cadeia de caracteres here, em uma tabela de hash. A tabela hash é atribuída à variável $TextMsgs.

A variável $TextMsgs não faz parte da seção data.

$TextMsgs = data {
    ConvertFrom-StringData -StringData @'
Text001 = Windows 7
Text002 = Windows Server 2008 R2
'@
}

Para aceder às chaves e aos valores na tabela hash em $TextMsgs, utilize os seguintes comandos.

$TextMsgs.Text001
$TextMsgs.Text002

Como alternativa, você pode colocar o nome da variável na definição da seção data. Por exemplo:

data TextMsgs {
    ConvertFrom-StringData -StringData @'
Text001 = Windows 7
Text002 = Windows Server 2008 R2
'@
}

$TextMsgs

O resultado é o mesmo do exemplo anterior.

Name                           Value
----                           -----
Text001                        Windows 7
Text002                        Windows Server 2008 R2

Exemplos

Cadeias de dados simples.

data {
    "Thank you for using my PowerShell Organize.pst script."
    "It is provided free of charge to the community."
    "I appreciate your comments and feedback."
}

Strings que incluem variáveis permitidas.

data {
    if ($null) {
        "To get help for this cmdlet, type Get-Help New-Dictionary."
    }
}

Uma cadeia de caracteres entre aspas única que usa o ConvertFrom-StringData cmdlet:

data {
    ConvertFrom-StringData -StringData @'
Text001 = Windows 7
Text002 = Windows Server 2008 R2
'@
}

Uma cadeia de caracteres entre aspas duplas que usa o ConvertFrom-StringData cmdlet:

data {
    ConvertFrom-StringData -StringData @"
Msg1 = To start, press any key.
Msg2 = To exit, type "quit".
"@
}

Uma seção de dados que inclui um cmdlet escrito pelo usuário que gera dados:

data -SupportedCommand Format-Xml {
    Format-Xml -Strings string1, string2, string3
}

Consulte também

  • Last updated on