Freigeben über


über_If

Kurzbeschreibung

Beschreibt einen Sprachbefehl, mit dem Sie Anweisungslisten basierend auf den Ergebnissen einer oder mehrerer bedingter Tests ausführen können.

Lange Beschreibung

Sie können die if-Anweisung verwenden, um Codeblöcke auszuführen, wenn ein angegebener bedingter Test als "true" ausgewertet wird. Sie können auch einen oder mehrere zusätzliche bedingte Tests angeben, die ausgeführt werden sollen, wenn alle vorherigen Tests als falsch ausgewertet werden. Schließlich können Sie einen zusätzlichen Codeblock angeben, der ausgeführt wird, wenn kein anderer vorheriger bedingter Test als "true" ausgewertet wird.

Syntax

Das folgende Beispiel zeigt die Syntax der if-Anweisung:

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

Wenn Sie eine if-Anweisung ausführen, wertet PowerShell den <test1> bedingten Ausdruck als "true" oder "false" aus. Wenn <test1> wahr ist, wird <statement list 1> ausgeführt, und PowerShell beendet die if-Anweisung. Wenn <test1> "false" ist, wertet PowerShell die durch die <test2> bedingungsbedingte Anweisung angegebene Bedingung aus.

Weitere Informationen zur booleschen Auswertung finden Sie unter about_Booleans.

Wenn <test2> wahr ist, wird <statement list 2> ausgeführt, und PowerShell beendet die if-Anweisung. Wenn sowohl <test1> als auch <test2> als falsch ausgewertet werden, wird der <statement list 3> Codeblock ausgeführt, und PowerShell beendet die if-Anweisung.

Sie können mehrere elseif-Anweisungen verwenden, um eine Reihe von bedingten Tests zu verketten. Jeder Test wird nur ausgeführt, wenn alle vorherigen Tests falsch sind. Wenn Sie eine if-Anweisung erstellen müssen, die viele elseif Anweisungen enthält, sollten Sie stattdessen eine Switch-Anweisung verwenden.

Beispiele

Die einfachste if-Anweisung enthält einen einzelnen Befehl und enthält keine elseif Anweisungen oder else Anweisungen. Das folgende Beispiel zeigt die einfachste Form der if-Anweisung:

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

Wenn die $a Variable in diesem Beispiel größer als 2ist, wird die Bedingung als wahr ausgewertet, und die Anweisungsliste wird ausgeführt. Wenn $a jedoch kleiner oder gleich 2 ist oder keine vorhandene Variable ist, zeigt die if-Anweisung keine Meldung an.

Durch Hinzufügen einer Else-Anweisung wird eine Meldung angezeigt, wenn $a kleiner oder gleich 2 ist. Wie das nächste Beispiel zeigt:

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.")
}

Um dieses Beispiel weiter zu verfeinern, können Sie die elseif-Anweisung verwenden, um eine Meldung anzuzeigen, wenn der Wert von $a gleich 2ist. Wie das nächste Beispiel zeigt:

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.")
}

Verwenden der ternären Operatorsyntax

PowerShell 7.0 hat eine neue Syntax mit dem ternären Operator eingeführt. Es folgt der Syntax des C#-ternären Operators:

<condition> ? <if-true> : <if-false>

Der ternäre Operator verhält sich wie die vereinfachte if-else-Anweisung. Der <condition> Ausdruck wird ausgewertet, und das Ergebnis wird in einen booleschen Wert konvertiert, um zu bestimmen, welche Verzweigung als Nächstes ausgewertet werden soll:

  • Der <if-true> Ausdruck wird ausgeführt, wenn der <condition> Ausdruck wahr ist.
  • Der ausdruck <if-false> wird ausgeführt, wenn der <condition> Ausdruck "false" ist.

Beispiel:

$message = (Test-Path $path) ? "Path exists" : "Path not found"

In diesem Beispiel wird der Wert $messagePath exists, wenn Test-Path$truezurückgibt. Wenn Test-Path$falsezurückgibt, wird der Wert $messagePath not found.

$service = Get-Service BITS
$service.Status -eq 'Running' ? (Stop-Service $service) : (Start-Service $service)

In diesem Beispiel wird der Dienst beendet, und wenn der Status nicht Wird ausgeführt, wird er gestartet.

Wenn ein <condition>, <if-true>oder <if-false> Ausdruck einen Befehl aufruft, müssen Sie ihn in Klammern umschließen. Andernfalls löst PowerShell eine Argumentausnahme für den Befehl im <condition> Ausdruck aus und analysiert Ausnahmen für die ausdrücke <if-true> und <if-false> Ausdrücke.

PowerShell löst beispielsweise Ausnahmen für diese Ternaries aus:

Test-Path .vscode   ? Write-Host 'exists'   : Write-Host 'not found'
(Test-Path .vscode) ? Write-Host 'exists'   : Write-Host 'not found'
(Test-Path .vscode) ? (Write-Host 'exists') : Write-Host 'not found'
Test-Path: A positional parameter cannot be found that accepts argument '?'.
ParserError:
Line |
   1 |  (Test-Path .vscode) ? Write-Host 'exists'   : Write-Host 'not found'
     |                       ~
     | You must provide a value expression following the '?' operator.
ParserError:
Line |
   1 |  (Test-Path .vscode) ? (Write-Host 'exists') : Write-Host 'not found'
     |                                               ~
     | You must provide a value expression following the ':' operator.

Und in diesem Beispiel werden analysiert:

(Test-Path .vscode) ? (Write-Host 'exists') : (Write-Host 'not found')
exists

Siehe auch