ARGOMENTO

about_Language_Keywords

DESCRIZIONE BREVE
Descrive le parole chiave nel linguaggio di scripting di Windows
PowerShell.

DESCRIZIONE DETTAGLIATA
In Windows PowerShell sono presenti le parole chiave seguenti.
Per ulteriori informazioni, vedere l'argomento relativo alla
parola chiave e le informazioni riportate dopo la tabella.

Parola chiave Riferimento

------- ---------
Begin about_Functions, about_Functions_Advanced
Break about_Break, about_Trap
Catch about_Try_Catch_Finally
Continue about_Continue, about_Trap
Data about_Data_Sections
Do about_Do, about_While
Dynamicparam about_Functions_Advanced_Parameters
Else about_If
Elseif about_If
End about_Functions, about_Functions_Advanced_Methods
Exit Descritto in questo argomento.
Filter about_Functions
Finally about_Try_Catch_Finally
For about_For
Foreach about_Foreach
From Riservato per utilizzi futuri.
Function about_Functions, about_Functions_Advanced
If about_If
In about_Foreach
Param about_Functions
Process about_Functions, about_Functions_Advanced
Return about_Return
Switch about_Switch
Throw about_Throw, about_Functions_Advanced_Methods
Trap about_Trap, about_Break, about_Try_Catch_Finally
Try about_Try_Catch_Finally
Until about_Do
While about_While, about_Do

Parole chiave del linguaggio

Begin
-----

Specifica una parte del corpo di una funzione, insieme alle

parole chiave Dynamicparam, Process ed End. L'elenco di
istruzioni Begin viene eseguito una volta prima che qualsiasi
oggetto venga ricevuto dalla pipeline.

Sintassi:

function <nome> {
dynamicparam {<elenco istruzioni>}
 begin {<elenco istruzioni>}
process {<elenco istruzioni>}
end {<elenco istruzioni>}
}

Break
-----

Causa l'uscita di uno script da un ciclo.

Sintassi:

while (<condizione>) {
<istruzioni>
...
break
...
<istruzioni>
}

Catch
-----

Specifica un elenco di istruzioni da eseguire se si verifica un

errore nell'elenco di istruzioni Try associato. Un tipo di
errore richiede l'uso di parentesi. La seconda coppia di
parentesi indica che il tipo di errore è facoltativo.

Sintassi:

try {<elenco istruzioni>}

catch [[<tipo di errore>]] {<elenco istruzioni>}

Continue
--------

Causa l'arresto dell'esecuzione di un ciclo da parte di uno

script e il ritorno alla condizione. Se la condizione viene
soddisfatta, lo script inizia nuovamente il ciclo.

Sintassi:

while (<condizione>) {
<istruzioni>
...
continue
...
<istruzioni>
}

Data
----

In uno script, definisce una sezione che isola i dati dalla

logica dello script. Può includere anche istruzioni If e alcuni
comandi limitati.

Sintassi:
data <variabile> [-supportedCommand <nome-cmdlet>] {<contenuto
consentito>}

Do
--

Utilizzata con la parola chiave While o Until come costrutto di

ciclo. In Windows PowerShell l'elenco di istruzioni viene
eseguito almeno una volta, a differenza di un ciclo con la
parola chiave While.

Sintassi:

do {<elenco istruzioni>} while (<condizione>)

do {<elenco istruzioni>} until (<condizione>)

Dynamicparam
------------

Specifica una parte del corpo di una funzione, insieme alle

parole chiave Begin, Process ed End. I parametri dinamici
vengono aggiunti in fase di esecuzione.

Sintassi:

function <nome> {
dynamicparam {<elenco istruzioni>}
begin {<elenco istruzioni>}
process {<elenco istruzioni>}
end {<elenco istruzioni>}
}

Else
----

Utilizzata con la parola chiave If per specificare l'elenco di

istruzioni predefinito.

Sintassi:

if (<condizione>) {<elenco istruzioni>}

else {<elenco istruzioni>}

Elseif
------

Utilizzata con le parole chiave If ed Else parole per specificare

istruzioni condizionali aggiuntive. La parola chiave Else è facoltativa.

Sintassi:

if (<condizione>) {<elenco istruzioni>}

elseif (<condizione>) {<elenco istruzioni>}
else {<elenco istruzioni>}

End
---
Specifica una parte del corpo di una funzione, insieme alle
parole chiave Dynamicparam, Begin e Process. L'elenco di
istruzioni End viene eseguito una volta dopo la ricezione di
tutti gli oggetti dalla pipeline.

Sintassi:

function <nome> {
dynamicparam {<elenco istruzioni>}
begin {<elenco istruzioni>}
process {<elenco istruzioni>}
end {<elenco istruzioni>}
}

Exit
----

Causa l'uscita di Windows PowerShell da uno script o da

un'istanza di Windows PowerShell.

Sintassi:

exit

Filter
------

Specifica una funzione in cui l'elenco di istruzioni viene

eseguito una volta per ogni oggetto di input. Ha lo stesso
effetto di una funzione che contiene solo un blocco Process.

Sintassi:

filter <nome> {<elenco istruzioni>}

Finally
-------

Definisce un elenco di istruzioni che viene eseguito dopo le

istruzioni associate a Try e Catch. Un elenco di istruzioni
Finally viene eseguito anche se si preme CTRL+C per uscire da
uno script o se si utilizza la parola chiave Exit nello script.

Sintassi:

try {<elenco istruzioni>}

catch [<tipo di errore>] {<elenco istruzioni>}
finally {<elenco istruzioni>}

For
---

Definisce un ciclo tramite una condizione.

Sintassi:

for (<inizializzare>; <condizione>; <iterare>) {<elenco

istruzioni>}
Foreach
-------

Definisce un ciclo tramite ogni membro di una raccolta.

Sintassi:

foreach (<elemento> in <raccolta>){<elenco istruzioni>}

From
-----

Riservato per utilizzi futuri.

Function
--------

Crea un elenco di istruzioni denominato di codice riutilizzabile.

È possibile assegnare un nome all'ambito al quale appartiene una funzione.
È inoltre possibile specificare uno o più parametri denominati tramite
la parola chiave Param. All'interno dell'elenco di istruzioni Function,
è possibile includere gli elenchi di istruzioni Dynamicparam, Begin,
Process ed End.

Sintassi:

function [<scope:>]<name> {
param ([type]<$pname1> [, [type]<$pname2>])
dynamicparam {<statement list>}
begin {<statement list>}
process {<statement list>}
end {<statement list>}
}

È inoltre possibile definire uno o più parametri all'esterno

dell'elenco di istruzioni dopo il nome della funzione.

Sintassi:

function [<scope:>]<name> [([type]<$pname1>, [[type]<$pname2>])] {

dynamicparam {<statement list>}
begin {<statement list>}
process {<statement list>}
end {<statement list>}
}

If
--

Definisce un'istruzione condizionale.

Sintassi:

if (<condizione>) {<elenco istruzioni>}

In
--

Utilizzata in un'istruzione Foreach per creare un ciclo che

utilizza ogni membro di una raccolta.

Sintassi:

foreach (<elemento> in <raccolta>){<elenco istruzioni>}

Param
-----

Definisce i parametri in una funzione.

Sintassi:

function [<scope:>]<name> {
param ([type]<$pname1>[, [[type]<$pname2>]])
<statement list>
}

Process
-------

Specifica una parte del corpo di una funzione, insieme alle

parole chiave Dynamicparam, Begin ed End. Quando un elenco di
istruzioni Process riceve input dalla pipeline, l'elenco di
istruzioni Process viene eseguito una volta per ogni elemento dalla
pipeline. Se la pipeline non fornisce oggetti, l'elenco di istruzioni
Process non viene eseguito. Se il comando è il primo nella pipeline,
l'elenco di istruzioni Process viene eseguito una volta.

Sintassi:

function <nome> {
dynamicparam {<elenco istruzioni>}
begin {<elenco istruzioni>}
process {<elenco istruzioni>}
end {<elenco istruzioni>}
}

Return
------

Causa l'uscita di Windows PowerShell dall'ambito corrente, ad

esempio uno script o una funzione, e scrive l'espressione
facoltativa nell'output.

Sintassi:

return [<espressione>]

Switch
------

Specifica diverse azioni da eseguire sugli elementi dalla

pipeline o da un file. È possibile utilizzare uno dei modelli
di sintassi seguenti.

Sintassi 1:
 switch [-regex|-wildcard|-exact][-casesensitive] ( pipeline )
{
<stringa>|<numero>|<variabile>|{ <espressione> } {<elenco
istruzioni>}
<stringa>|<numero>|<variabile>|{ <espressione> } {<elenco
istruzioni>}
...
default {<elenco istruzioni>}
}

Sintassi 2:

switch [-regex|-wildcard|-exact][-casesensitive] -file

nomefile {
<stringa>|<numero>|<variabile>|{ <espressione> } {<elenco
istruzioni>}
<stringa>|<numero>|<variabile>|{ <espressione> } {<elenco
istruzioni>}
...
default {<elenco istruzioni>}
}

Throw
-----

Genera un oggetto come errore.

Sintassi:

throw [<oggetto>]

Trap
----

Definisce un elenco di istruzioni da eseguire se viene rilevato

un errore. Un tipo di errore richiede l'uso di parentesi. La seconda
coppia di parentesi indica che il tipo di errore è facoltativo.

Sintassi:

trap [[<tipo di errore>]] {<elenco istruzioni>}

Try
---

Definisce un elenco di istruzioni in cui verificare la presenza

di errori durante l'esecuzione delle istruzioni. Se si verifica
un errore, l'esecuzione di Windows PowerShell continua in
un'istruzione Catch o Finally. Un tipo di errore richiede l'uso di
parentesi. La seconda coppia di parentesi indica che il tipo di errore è
facoltativo.

Sintassi:

try {<elenco istruzioni>}

catch [[<tipo di errore>]] {<elenco istruzioni>}
finally {<elenco istruzioni>}
 Until
-----

Utilizzata in un'istruzione Do come costrutto di ciclo in cui viene

eseguito almeno una volta l'elenco di istruzioni.

Sintassi:

do {<elenco istruzioni>} until (<condizione>)

While
-----

Utilizzata in un'istruzione Do come costrutto di ciclo in cui viene

eseguito almeno una volta l'elenco di istruzioni.

Sintassi:

do {<elenco istruzioni>} while (<condizione>)

VEDERE ANCHE
about_escape_characters
about_special_characters
about_wildcards