about_Switch

Articolo
03/24/2025

Descrizione breve

Viene illustrato come usare un'opzione per gestire più if istruzioni.

Descrizione lunga

Per controllare una condizione in uno script o in una funzione, usare un'istruzione if . L'istruzione if può controllare molti tipi di condizioni, tra cui il valore delle variabili e le proprietà degli oggetti.

Per controllare più condizioni, usare un'istruzione switch . L'istruzione switch equivale a una serie di istruzioni if, ma è più semplice. L'istruzione switch elenca ogni condizione e un'azione facoltativa. Se viene ottenuta una condizione, viene eseguita l'azione.

L'istruzione switch può usare le $_ variabili automatiche e $switch . Per altre informazioni, vedere about_Automatic_Variables.

Sintassi

Un'istruzione di base switch ha il formato seguente:

switch (<test-expression>)
{
    <result1-to-be-matched> {<action>}
    <result2-to-be-matched> {<action>}
}

Le istruzioni equivalenti if sono:

if (<result1-to-be-matched> -eq (<test-expression>)) {<action>}
if (<result2-to-be-matched> -eq (<test-expression>)) {<action>}

Il <test-expression> è una singola espressione valutata in modalità espressione per restituire un valore.

<result-to-be-matched> è un'espressione il cui valore viene confrontato con il valore di input. Le espressioni includono valori letterali (stringhe o numeri), variabili e scriptblock che restituiscono un valore booleano.

Qualsiasi valore non racchiuso tra virgolette non riconosciuto come numero viene considerato come stringa. Per evitare confusione o conversione di stringhe indesiderate, è consigliabile usare sempre valori stringa tra virgolette. Racchiudere tutte le espressioni tra parentesi (), creando sottoespressioni, per assicurarsi che l'espressione venga valutata correttamente.

È importante comprendere che il valore <result-to-be-matched> si trova sul lato sinistro dell'espressione di confronto. Ciò significa che il risultato di <test-expression> è sul lato destro, che può essere convertito nel tipo del valore sul lato sinistro per il confronto. Per altre informazioni, vedere about_Comparison_Operators

Il valore default è riservato per l'azione utilizzata quando non sono presenti altre corrispondenze.

La $_ variabile automatica contiene il valore dell'espressione passata all'istruzione ed è disponibile per la switch valutazione e l'uso nell'ambito delle <result-to-be-matched> istruzioni.

La sintassi completa switch dell'istruzione è la seguente:

switch [-Regex | -Wildcard | -Exact] [-CaseSensitive] (<test-expression>) {
    string | number | variable | { <value-scriptblock> }
        { <action-scriptblock> }
    default { <action-scriptblock> } # optional
}

switch [-Regex | -Wildcard | -Exact] [-CaseSensitive] -File filename {
    string | number | variable | { <value-scriptblock> }
        { <action-scriptblock> }
    default { <action-scriptblock> }  # optional
}

Se non si usano parametri, switch si comporta allo stesso modo dell'uso del parametro Exact. Esegue una corrispondenza senza distinzione tra maiuscole e minuscole per il valore. Se il valore è una raccolta, ogni elemento viene valutato nell'ordine in cui viene visualizzato.

L'istruzione switch deve includere almeno un'istruzione condition.

La clausola default viene attivata quando il valore non corrisponde ad alcuna delle condizioni. Equivale a una clausola else in un'istruzione if. In ogni default istruzione è consentita una switch sola clausola.

switch ha i parametri seguenti:

Carattere jolly: indica che la condizione è una stringa con caratteri jolly. Se la clausola match non è una stringa, il parametro viene ignorato. Il confronto non fa distinzione tra maiuscole e minuscole.
esatto : indica che la clausola di corrispondenza, se si tratta di una stringa, deve corrispondere esattamente. Se la clausola match non è una stringa, questo parametro viene ignorato. Il confronto non fa distinzione tra maiuscole e minuscole.
CaseSensitive : esegue una corrispondenza con distinzione tra maiuscole e minuscole. Se la clausola match non è una stringa, questo parametro viene ignorato.
File: accetta input da un file anziché da un <test-expression>. Il file viene letto una riga alla volta e valutata dall'istruzione switch. Per impostazione predefinita, il confronto non fa distinzione tra maiuscole e minuscole. Il parametro file supporta un solo file. Se sono inclusi più parametri file , viene usato solo l'ultimo parametro. Per altre informazioni, vedere esempi di parametri file.
Regex : esegue la corrispondenza dell'espressione regolare del valore alla condizione. Se la clausola match non è una stringa, questo parametro viene ignorato. Il confronto non fa distinzione tra maiuscole e minuscole. La $Matches variabile automatica è disponibile per l'uso all'interno del blocco di istruzioni corrispondente.

Nota

Quando si specificano valori in conflitto, ad esempio Regex e Wildcard, l'ultimo parametro specificato ha la precedenza e tutti i parametri in conflitto vengono ignorati. Sono consentite anche più istanze di parametri. Tuttavia, viene usato solo l'ultimo parametro elencato.

Esempi di corrispondenze semplici

Nell'esempio seguente, l'istruzione switch confronta il valore del test 3 con ognuna delle condizioni. Quando il valore del test corrisponde alla condizione, viene eseguita l'azione.

switch (3) {
    1 { "It's one."   }
    2 { "It's two."   }
    3 { "It's three." }
    4 { "It's four."  }
}

It's three.

In questo esempio, il valore viene confrontato con ogni condizione nell'elenco. L'istruzione switch seguente presenta due condizioni per un valore pari a 3, che dimostra che vengono testate tutte le condizioni.

switch (3) {
    1 { "It's one."    }
    2 { "It's two."    }
    3 { "It's three."  }
    4 { "It's four."   }
    3 { "Three again." }
}

It's three.
Three again.

Per indirizzare l'oggetto a interrompere il switch confronto dopo una corrispondenza, usare l'istruzione break . L'istruzione break termina l'istruzione switch .

switch (3) {
    1 { "It's one."           }
    2 { "It's two."           }
    3 { "It's three."; break  }
    4 { "It's four."          }
    3 { "Three again."        }
}

It's three.

Se il valore di test è una raccolta, ad esempio una matrice, ogni elemento della raccolta viene valutato nell'ordine in cui viene visualizzato. Gli esempi seguenti valutano 4 e quindi 2.

switch (4, 2) {
    1 { "It's one."    }
    2 { "It's two."    }
    3 { "It's three."  }
    4 { "It's four."   }
    3 { "Three again." }
}

It's four.
It's two.

Tutte break le istruzioni si applicano alla raccolta, non a ogni valore, come illustrato nell'esempio seguente. L'istruzione switch viene terminata dall'istruzione break nella condizione del valore 4.

switch (4, 2) {
    1 { "It's one.";    break }
    2 { "It's two." ;   break }
    3 { "It's three." ; break }
    4 { "It's four." ;  break }
    3 { "Three again."        }
}

It's four.

Esempi di corrispondenze più complesse

In questo esempio l'istruzione esegue il switch test per il tipo del valore nella tabella hash. È necessario usare ed espressione che restituisce un valore booleano per selezionare lo scriptblock da eseguire.

$var = @{A = 10; B = 'abc'}

foreach ($key in $var.Keys) {
    switch ($var[$key].GetType()) {
        { $_ -eq [int32]  }  { "$key + 10 = $($var[$key] + 10)" }
        { $_ -eq [string] }  { "$key = $($var[$key])"           }
    }
}

A + 10 = 20
B = abc

In questo esempio, un oggetto che non è una stringa o dati numerici viene passato a switch. esegue switch una coercizione di stringa sull'oggetto e valuta il risultato.

$test = @{
    Test  = 'test'
    Test2 = 'test2'
}

$test.ToString()

switch -Exact ($test) {
    'System.Collections.Hashtable' { 'Hashtable string coercion' }
    'test'                         { 'Hashtable value' }
}

System.Collections.Hashtable
Hashtable string coercion

In questo esempio non esiste alcuna distinzione tra maiuscole e minuscole, quindi non è presente alcun output.

switch ("fourteen") {
    1     { "It's one.";   break }
    2     { "It's two.";   break }
    3     { "It's three."; break }
    4     { "It's four.";  break }
    "fo*" { "That's too many."   }
}

Aggiungendo la default clausola , è possibile eseguire un'azione quando nessuna altra condizione ha esito positivo.

switch ("fourteen") {
    1       { "It's one.";   break }
    2       { "It's two.";   break }
    3       { "It's three."; break }
    4       { "It's four.";  break }
    "fo*"   { "That's too many."   }
    default { "No matches"         }
}

No matches

Affinché la parola fourteen corrisponda a un caso, è necessario usare il parametro -Wildcard o -Regex.

switch -Wildcard ("fourteen") {
    1     { "It's one.";   break }
    2     { "It's two.";   break }
    3     { "It's three."; break }
    4     { "It's four.";  break }
    "fo*" { "That's too many."   }
}

That's too many.

Nell'esempio seguente viene usato il -Regex parametro .

$target = 'https://bing.com'
switch -Regex ($target) {
    '^ftp\://.*$'
        {
            "$_ is an ftp address"
            break
        }
    '^\w+@\w+\.com|edu|org$'
        {
            "$_ is an email address"
            break
        }
    '^(http[s]?)\://.*$'
        {
            "$_ is a web address that uses $($Matches[1])"
            break
        }
}

https://bing.com is a web address that uses https

Nell'esempio seguente viene illustrato l'uso di blocchi di script come switch condizioni di istruzione.

switch ("Test") {
    { $_ -is [string] } { "Found a string" }
    "Test"              { "This $_ executes as well" }
}

Found a string
This Test executes as well

Nell'esempio seguente viene elaborata una matrice contenente due valori di data. Confronta <value-scriptblock> la proprietà Year di ogni data. <action-scriptblock> Visualizza un messaggio di benvenuto o il numero di giorni fino all'inizio dell'anno 2022.

switch ((Get-Date 1-Jan-2022), (Get-Date 25-Dec-2021)) {
    { $_.Year -eq 2021 }
        {
            $days = ((Get-Date 1/1/2022) - $_).Days
            "There are $days days until 2022."
        }
    { $_.Year -eq 2022 } { 'Welcome to 2022!' }
}

Se il valore corrisponde a più condizioni, viene eseguita l'azione per ogni condizione. Per modificare questo comportamento, usare le break parole chiave o continue .

La break parola chiave interrompe l'elaborazione ed esce dall'istruzione switch .

La continue parola chiave interrompe l'elaborazione del valore corrente, ma continua l'elaborazione dei valori successivi.

L'esempio seguente elabora una matrice di numeri e visualizza se sono dispari o pari. I numeri negativi vengono ignorati con la continue parola chiave . Se viene rilevato un numero diverso da un numero, l'esecuzione viene terminata con la break parola chiave .

switch (1,4,-1,3,"Hello",2,1) {
    {$_ -lt 0}           { continue }
    {$_ -isnot [int32]}  { break }
    {$_ % 2}             { "$_ is Odd" }
    {-not ($_ % 2)}      { "$_ is Even" }
}

1 is Odd
4 is Even
3 is Odd

Esempi di parametri di file

L'uso dell'istruzione switch con il parametro file è un modo efficiente per elaborare file di grandi dimensioni riga per riga. PowerShell trasmette le righe del file all'istruzione switch. Ogni riga viene elaborata singolarmente.

È possibile terminare l'elaborazione prima di raggiungere la fine del file usando la parola chiave break nell'istruzione action. L'istruzione switch è più efficiente rispetto all'uso di Get-Content per elaborare file di grandi dimensioni riga per riga.

È possibile combinare switch -File con -Wildcard o -Regex per criteri line-by-line flessibili ed efficienti.

Nell'esempio seguente viene letto il README.md nel repository PowerShell-Docs. Restituisce ogni riga fino a raggiungere la riga che inizia con ##.

switch -Regex -File .\README.md {
    '^##\s' { break }
    default { $_; continue }
}

L'argomento <filename> viene interpretato come espressione con caratteri jolly, ma deve corrispondere a un solo file. L'esempio seguente è uguale a quello precedente, ad eccezione del fatto che usa un carattere jolly nell'argomento <filename>. Questo esempio funziona perché il criterio con caratteri jolly corrisponde a un solo file.

switch -Regex -File .\README.* {
    '^##\s' { break }
    default { $_; continue }
}

È necessario usare caratteri di escape che possono essere interpretati come caratteri jolly se si desidera che vengano considerati come valori letterali.

$file = (New-Item -Path 'Temp:\Foo[0]' -Value Foo -Force).FullName
switch -File $file { Foo { 'Foo' } }
# No files matching '...\Temp\Foo[0]' were found.

$fileEscaped = [WildcardPattern]::Escape($file)
switch -File $fileEscaped { foo { 'Foo' } }
# Foo

Condividi tramite