ARGOMENTO

about_Data_Sections

DESCRIZIONE BREVE
Illustra le sezioni Data in cui le stringhe di testo e altri dati
di sola lettura vengono isolati dalla logica dello script.

DESCRIZIONE DETTAGLIATA
Negli script progettati per Windows PowerShell possono essere
presenti una o più sezioni Data che contengono solo dati. È possibile
includere una o più sezioni Data in qualsiasi script, funzione o funzione
avanzata. Il contenuto della sezione Data è limitato a un sottoinsieme
specificato del linguaggio di script di Windows PowerShell.

La separazione dei dati dal codice logico rende più semplice

l'identificazione e la gestione di logica e dati. Consente di
disporre di file di risorse di tipo stringa separati per il testo,
ad esempio messaggi di errore e stringhe della Guida. Isola inoltre
il codice logico che facilita i test di convalida e sicurezza.

In Windows PowerShell, la sezione Data viene utilizzata per supportare

l'internazionalizzazione degli script. È possibile utilizzare le
sezioni Data per facilitare l'isolamento, l'individuazione e
l'elaborazione di stringhe che verranno tradotte in molte lingue
dell'interfaccia utente.

La sezione Data è una funzionalità di Windows PowerShell 2.0. Gli

script con le sezioni Data non verranno eseguiti in Windows
PowerShell 1.0 senza revisione.

Sintassi

La sintassi della sezione Data è la seguente:

DATA [-supportedCommand <nome-cmdlet>] {

<Contenuto consentito>
}

La parola chiave Data è obbligatoria. Non viene applicata la

distinzione tra maiuscole e minuscole.

Il contenuto consentito è limitato agli elementi seguenti:

- Tutti gli operatori di Windows PowerShell, eccetto -match

- Le istruzioni If, Else e Elseif

- Le variabili automatiche seguenti: $PsCulture, $PsUICulture, $True,

$False e $Null

- Commenti

- Pipeline

- Le istruzioni separate da punto e virgola (;)

 - I valori letterali, come:

1,2,3

"Windows PowerShell 2.0"

@( "red", "green", "blue" )

@{ a = 0x1; b = "great"; c ="script" }

[XML] @'
<p> Hello, World </p>
'@

- I cmdlet consentiti in una sezione Data. Per impostazione

predefinita, è consentito solo il cmdlet ConvertFrom-StringData.

- I cmdlet consentiti in una sezione Data tramite il parametro

SupportedCommand.

Quando si utilizza il cmdlet ConvertFrom-StringData in una

sezione Data, è possibile racchiudere le coppie chiave/valore in
stringhe o in stringhe here tra virgolette singole o doppie.
Tuttavia, è necessario che le stringhe che contengono variabili e
sottoespressioni vengano racchiuse in stringhe o stringhe here tra
virgolette singole in modo che le variabili non vengano espanse e
le sottoespressioni non siano eseguibili.

SupportedCommand

Il parametro SupportedCommand consente di indicare che un

cmdlet o una funzione genera solo dati. È progettato per
consentire agli utenti di includere cmdlet e funzioni in una
sezione Data scritta o sottoposta a test.

Il valore di SupportedCommand è un elenco di uno o più cmdlet o

di nomi di funzione separati da virgole.

Ad esempio, nella sezione Data seguente viene incluso un cmdlet

scritto dall'utente, Format-XML, che formatta dati in un file XML:

DATA -supportedCommand Format-XML

{
Format-XML -strings string1, string2, string3
}

Utilizzo di una sezione Data

Per utilizzare il contenuto di una sezione Data, assegnarlo a una

variabile e utilizzare la notazione della variabile per accedere al
 contenuto.

La sezione Data seguente, ad esempio, contiene un comando

ConvertFrom-StringData che converte la stringa here in una
tabella hash. La tabella hash viene assegnata alla variabile
$TextMsgs.

La variabile $TextMsgs non fa parte della sezione Data.

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

Per accedere alle chiavi e ai valori nella tabella hash in

$TextMsgs, utilizzare i comandi seguenti.

$TextMsgs.Text001
$TextMsgs.Text002

ESEMPI

Stringhe di dati semplici.

DATA {
"Grazie per aver utilizzato lo script Windows PowerShell
Organize.pst script". "È gratuito per la community." "Sarò felice di
ricevere commenti e suggerimenti."
}

Stringhe che includono variabili consentite.

DATA {
if ($null) {
"Per visualizzare la Guida relativa a questo cmdlet, digitare
get-help new-dictionary."
}
}

Stringa here racchiusa tra virgolette singole che utilizza il cmdlet

ConvertFrom-StringData:

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

Stringa here racchiusa tra virgolette doppie che utilizza il cmdlet

ConvertFrom-StringData:
 DATA {
ConvertFrom-StringData -stringdata @"
Msg1 = Per iniziare,
premere un tasto qualsiasi.
Msg2 = Per uscire, digitare "quit".
"@
}

Sezione Data che include un cmdlet scritto dall'utente che genera

dati:

DATA -supportedCommand Format-XML {

Format-XML -strings string1, string2, string3
}

VEDERE ANCHE
about_Automatic_Variables
about_Comparison_Operators
about_Hash_Tables
about_If
about_Operators
about_Quoting_Rules
about_Script_Internationalization
ConvertFrom-StringData
Import-LocalizedData