about_Pipeline_Chain_Operators

Kısa açıklama

PowerShell'deki && ve || işleçleriyle zincirleme işlem hatlarını açıklar.

Uzun açıklama

PowerShell 7'de başlayarak PowerShell, && ve || işleçlerini koşullu olarak zincirleme işlem hatlarına uygular. Bu işleçler PowerShell'de işlem hattı zinciri işleçleri olarak bilinir ve bash, zsh ve sh gibi POSIX kabuklarında AND-OR listeleri ile Windows Komut Kabuğu'nda (cmd.exe) koşullu işleme simgeleri benzer.

soldaki işlem hattı başarılı olursa && işleci sağ işlem hattını yürütür. Buna karşılık, soldaki işlem hattı başarısız olursa || işleci sağ işlem hattını yürütür.

Bu işleçler, bir işlem hattının başarısız olup olmadığını belirlemek için $? ve $LASTEXITCODE değişkenlerini kullanır. Bu, bunları yalnızca cmdlet'ler veya işlevlerle değil yerel komutlarla kullanmanıza olanak tanır. Mesela:

# Create an SSH key pair - if successful copy the public key to clipboard
ssh-keygen -t rsa -b 2048 && Get-Content -Raw ~\.ssh\id_rsa.pub | clip

Örnekler

İki başarılı komut

Write-Output 'First' && Write-Output 'Second'

First
Second

İlk komut başarısız olur ve ikincinin yürütülememesine neden olur

Write-Error 'Bad' && Write-Output 'Second'

Write-Error: Bad

İlk komut başarılı olur, bu nedenle ikinci komut yürütülmez

Write-Output 'First' || Write-Output 'Second'

First

İlk komut başarısız olduğundan ikinci komut yürütülür

Write-Error 'Bad' || Write-Output 'Second'

Write-Error: Bad
Second

İşlem hattı başarısı, PowerShell'in yürütme durumuna göre bir işlem hattını yürüttükten sonra otomatik olarak ayarladığı $? değişkeninin değeriyle tanımlanır. Bu, işlem hattı zinciri işleçlerinin aşağıdaki eşdeğerliğe sahip olduğu anlamına gelir:

Test-Command '1' && Test-Command '2'

ile aynı şekilde çalışır

Test-Command '1'; if ($?) { Test-Command '2' }

ve

Test-Command '1' || Test-Command '2'

ile aynı şekilde çalışır

Test-Command '1'; if (-not $?) { Test-Command '2' }

İşlem hattı zincirlerinden atama

bir işlem hattı zincirinden değişken atamak, zincirdeki tüm işlem hatlarının birleştirmesini alır:

$result = Write-Output '1' && Write-Output '2'
$result

1
2

İşlem hattı zincirinden atama sırasında bir betik sonlandırma hatası oluşursa atama başarılı olmaz:

try
{
    $result = Write-Output 'Value' && $(throw 'Bad')
}
catch
{
    # Do nothing, just squash the error
}

"Result: $result"

Result:

İşleç söz dizimi ve öncelik

Diğer işleçlerden farklı olarak, && ve ||, örneğin + veya -andgibi ifadeler yerine işlem hatlarında çalışır.

&& ve ||, piping (|) veya yeniden yönlendirmeden (>), ama iş işleçlerinden (&), atamadan (=) veya noktalı virgülden (;) daha yüksek önceliğe sahiptir. Bu, işlem hattı zincirindeki işlem hatlarının tek tek yeniden yönlendirilebileceği ve işlem hattı zincirlerinin tamamının arka planlı olarak, değişkenlere atanabileceği veya deyim olarak ayrılabileceği anlamına gelir.

İşlem hattı zincirinde daha düşük öncelik söz dizimi kullanmak için (...)parantez kullanımını göz önünde bulundurun. Benzer şekilde, bir deyimi bir işlem hattı zincirine eklemek için alt ifade $(...) kullanılabilir. Bu, yerel komutları denetim akışıyla birleştirmek için yararlı olabilir:

foreach ($file in 'file1','file2','file3')
{
    # When find succeeds, the loop breaks
    find $file && Write-Output "Found $file" && $(break)
}

find: file1: No such file or directory
file2
Found file2

PowerShell 7'de bu söz dizimlerinin davranışı, komut parantez içinde veya alt ifade içinde başarılı olduğunda veya başarısız olduğunda $? beklendiği gibi ayarlanacağı şekilde değiştirilmiştir.

PowerShell'deki diğer işleçlerin çoğu gibi, && ve || de soldan gruplandırdıkları anlamına gelen . Mesela:

Get-ChildItem -Path ./file.txt ||
    Write-Error "file.txt doesn't exist" &&
    Get-Content -Raw ./file.txt

şu şekilde gruplandırılır:

(Get-ChildItem -Path ./file.txt || Write-Error "file.txt doesn't exist") &&
    Get-Content -Raw ./file.txt

şu değere eşdeğerdir:

Get-ChildItem -Path ./file.txt

if (-not $?) { Write-Error "file.txt does not exist" }

if ($?) { Get-Content -Raw ./file.txt }

Hata etkileşimi

İşlem hattı zinciri işleçleri hataları emmiyor. İşlem hattı zincirindeki bir deyim betik sonlandırıcı bir hata oluşturursa işlem hattı zinciri sonlandırılır.

Mesela:

$(throw 'Bad') || Write-Output '2'

Exception: Bad

Hata yakalansa bile işlem hattı zinciri sonlandırılır:

try
{
    $(throw 'Bad') || Write-Output '2'
}
catch
{
    Write-Output "Caught: $_"
}
Write-Output 'Done'

Caught: Bad
Done

Bir hata sonlandırıcı değilse veya yalnızca bir işlem hattını sonlandırırsa işlem hattı zinciri devam eder ve $?değerine saygı gösterir:

function Test-NonTerminatingError
{
    [CmdletBinding()]
    param()

    $exception = [System.Exception]::new('BAD')
    $errorId = 'BAD'
    $errorCategory = 'NotSpecified'

    $errorRecord = [System.Management.Automation.ErrorRecord]::new(
        $exception, $errorId, $errorCategory, $null
    )

    $PSCmdlet.WriteError($errorRecord)
}

Test-NonTerminatingError || Write-Output 'Second'

Test-NonTerminatingError: BAD
Second

Komutlar yerine işlem hatlarını zincirleme

İşlem hattı zinciri işleçleri, yalnızca komutlar yerine işlem hatlarını zincirleme için kullanılabilir. Bu, diğer kabukların davranışıyla eşleşir, ancak başarının belirlenmesini zorlaştırabilir:

function Test-NotTwo
{
    [CmdletBinding()]
    param(
      [Parameter(ValueFromPipeline)]
      $Input
    )

    process
    {
        if ($Input -ne 2)
        {
            return $Input
        }

        $exception = [System.Exception]::new('Input is 2')
        $errorId = 'InputTwo'
        $errorCategory = 'InvalidData'

        $errorRecord = [System.Management.Automation.ErrorRecord]::new(
            $exception, $errorId, $errorCategory, $null
        )

        $PSCmdlet.WriteError($errorRecord)
    }
}

1,2,3 | Test-NotTwo && Write-Output 'All done!'

1
Test-NotTwo : Input is 2
3

Write-Output 'All done!' sonlandırılmayan hata oluştuktan sonra başarısız olduğu varsayıldığından Test-NotTwo yürütülmediğini unutmayın.

Ayrıca bakınız

  • Son güncelleştirme: