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