Compartilhar via

about_If

  • Artigo

Descrição breve

Descreve um comando de idioma que você pode usar para executar listas de instruções com base nos resultados de um ou mais testes condicionais.

Descrição longa

Você pode usar a if instrução para executar blocos de código se um teste condicional especificado for avaliado como true. Você também pode especificar um ou mais testes condicionais adicionais a serem executados se todos os testes anteriores forem avaliados como falso. Finalmente, você pode especificar um bloco de código adicional que será executado se nenhum outro teste condicional anterior for avaliado como true.

Sintaxe

O exemplo a seguir mostra a sintaxe da if instrução:

if (<test1>)
    {<statement list 1>}
[elseif (<test2>)
    {<statement list 2>}]
[else
    {<statement list 3>}]

Quando você executa uma if instrução, o PowerShell avalia a <test1> expressão condicional como true ou false. Se <test1> for true, <statement list 1> é executado e o PowerShell sai da if instrução. Se <test1> for false, o PowerShell avaliará a condição especificada pela <test2> instrução condicional.

Para obter mais informações sobre avaliação booleana, consulte about_Booleans.

Se <test2> for true, <statement list 2> é executado e o PowerShell sai da if instrução. Se ambos <test1> e <test2> avaliar para false, o bloco de <statement list 3> código será executado e o PowerShell encerrará a if instrução.

Você pode usar várias elseif instruções para encadear uma série de testes condicionais. Cada teste será executado somente se todos os testes anteriores forem falsos. Se você precisar criar uma if instrução que contenha muitas elseif instruções, considere usar uma instrução Switch.

Exemplos:

A instrução mais if simples contém um único comando e não contém instruções elseif ou else quaisquer instruções. O exemplo a seguir mostra a forma mais simples da if instrução:

if ($a -gt 2) {
    Write-Host "The value $a is greater than 2."
}

Neste exemplo, se a $a variável for maior que 2, a condição será avaliada como true e a lista de instruções será executada. No entanto, se $a for menor ou igual a 2 ou não for uma variável existente, a instrução não exibirá if uma mensagem.

Ao adicionar uma instrução Else, uma mensagem é exibida quando $a é menor ou igual a 2. Como mostra o exemplo a seguir:

if ($a -gt 2) {
    Write-Host "The value $a is greater than 2."
}
else {
    Write-Host ("The value $a is less than or equal to 2," +
        " is not created or is not initialized.")
}

Para refinar ainda mais este exemplo, você pode usar a elseif instrução para exibir uma mensagem quando o valor de $a for igual a 2. Como mostra o exemplo a seguir:

if ($a -gt 2) {
    Write-Host "The value $a is greater than 2."
}
elseif ($a -eq 2) {
    Write-Host "The value $a is equal to 2."
}
else {
    Write-Host ("The value $a is less than 2 or" +
        " was not created or initialized.")
}

Confira também