about_Checkpoint-Workflow

Kısa açıklama

Bir iş akışında denetim noktası alan Denetim Noktası-İş Akışı etkinliğini açıklar.

Uzun açıklama

Checkpoint-Workflow etkinliği, durumu ve verileri iş akışına kaydeden bir denetim noktası alır. İş akışı askıya alınır veya kesintiye uğrarsa, yeniden başlatılması yerine en son denetim noktasından sürdürülebilir.

Checkpoint-Workflow etkinliği yalnızca bir iş akışında geçerlidir.

Sözdizimi

workflow <Verb-Noun> {
    Checkpoint-Workflow
}

Checkpoint-Workflow etkinliği, ortak parametreler ve iş akışı ortak parametreleri de dahil olmak üzere herhangi bir parametreyi kabul etmez.

CmdletBinding veya param deyiminden sonra Checkpoint-Activity denetim noktasını iş akışında herhangi bir yere yerleştirebilirsiniz. Ancak denetim noktaları yerleştirirken, verileri toplamanın ve iş akışını çalıştıran bilgisayardaki diske yazmanın performans maliyetini göz önünde bulundurun.

Kesintiye uğrarsa iş akışının bir bölümünü yeniden çalıştırmak için gereken sürenin denetim noktası durumunu ve verileri diske yazmak için gereken süreden uzun olduğundan emin olun.

İş akışının yeniden başlatılmak yerine sürdürülebilmesi için kritik adımlardan sonra denetim noktaları almayı göz önünde bulundurun. Örneğin, bir kez etkili olmayan komutların ardından bir denetim noktası alın.

Denetim noktaları hakkında

Denetim noktası, değişkenlerin geçerli değerleri ve bu noktaya kadar oluşturulan tüm çıkışlar dahil olmak üzere iş akışının geçerli durumunun anlık görüntüsüdür ve bunu diske kaydeder.

Bir iş akışı kasıtlı olarak veya istemeden kesilirse Windows PowerShell İş Akışı, iş akışını kurtarmak ve sürdürmek için en yeni denetim noktasındaki verileri otomatik olarak kullanır.

İş akışını, örneğin AsJob iş akışı ortak parametresini kullanarak bir iş olarak çalıştırdığınızda, iş akışı denetim noktaları siz işi silene kadar (örneğin Remove-Job cmdlet'ini kullanarak) korunur. Aksi takdirde iş akışı denetim noktaları iş akışı tamamlandığında silinir.

Diğer denetim noktası oluşturma teknikleri

Windows PowerShell İş Akışı, Checkpoint-Workflow etkinliğine ek olarak aşağıdakiler de dahil olmak üzere diğer denetim noktası oluşturma tekniklerini destekler:

• PSPersist iş akışı ortak parametresi
• PSPersist etkinliği ortak parametresi
• PSPersistPreference değişkeni (iş akışında)

bir iş akışına denetim noktası ekleme hakkında daha fazla bilgi için bkz. "İş Akışına Denetim Noktaları Ekleme."

Örnekler

Aşağıdaki iş akışı, uzun süre çalışan bir işlevi ve veri paylaşan bir betiği tamamladıktan sonra Checkpoint-Workflow etkinliğine yönelik bir çağrı içerir.

workflow Test-Workflow {
    $a = Invoke-LongRunningFunction
    inlinescript { \\Server\Share\Get-DataPacks.ps1 $Using:a}
    Checkpoint-Workflow

    Invoke-LongRunningFunction {
        ...
    }
}

Ayrıca bkz:

• Windows PowerShell İş Akışı Yazma