about_If
Kurze Beschreibung
Beschreibt einen Sprachbefehl, den Sie verwenden können, um Anweisungslisten basierend auf den Ergebnissen eines oder mehrerer bedingter Tests auszuführen.
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 false 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
Im folgenden Beispiel wird die -Anweisungssyntax if veranschaulicht:
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> true ist, <statement list 1> wird ausgeführt, und PowerShell beendet die if Anweisung. Wenn <test1> false ist, wertet PowerShell die bedingung aus, die von der bedingungsbedingten <test2> Anweisung angegeben wird.
Weitere Informationen zur booleschen Auswertung finden Sie unter about_Booleans.
Wenn <test2> true ist, <statement list 2> wird ausgeführt, und PowerShell beendet die if Anweisung. Wenn sowohl als auch <test1><test2> als false 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 false 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 true 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. 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. 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 Syntax des ternären Operators
PowerShell 7.0 hat eine neue Syntax mit dem ternären Operator eingeführt. Sie folgt der Syntax des ternären C#-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, welcher Branch als Nächstes ausgewertet werden soll:
- Der Ausdruck
<if-true>wird ausgeführt, wenn der Ausdruck<condition>TRUE ist. - Der Ausdruck
<if-false>wird ausgeführt, wenn der Ausdruck<condition>FALSE ist.
Beispiel:
$message = (Test-Path $path) ? "Path exists" : "Path not found"
In diesem Beispiel ist der Wert von$message, wenn Test-Path zurückgegeben $truewirdPath exists. Wenn Test-Path zurückgegeben wird$false, ist Path not foundder Wert von $message .
$service = Get-Service BITS
$service.Status -eq 'Running' ? (Stop-Service $service) : (Start-Service $service)
Wenn der Dienst in diesem Beispiel ausgeführt wird, wird er beendet, und wenn sein status nicht Ausgeführt ist, 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 <if-true> Ausdrücke und <if-false> .
PowerShell löst z. B. Ausnahmen für diese Ternärdateien 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.
In diesem Beispiel wird Folgendes analysiert:
(Test-Path .vscode) ? (Write-Host 'exists') : (Write-Host 'not found')
exists