about_Checkpoint-Workflow

  • Artikel

DESKRIPSI SINGKAT

Menjelaskan aktivitas Checkpoint-Workflow, yang mengambil titik pemeriksaan dalam alur kerja.

DESKRIPSI PANJANG

Aktivitas Checkpoint-Workflow mengambil titik pemeriksaan, yang menyimpan status dan data dalam alur kerja. Jika alur kerja ditangguhkan atau terganggu, alur kerja dapat dilanjutkan dari titik pemeriksaan terbaru, daripada harus dimulai ulang.

Aktivitas Checkpoint-Workflow hanya valid dalam alur kerja.

SINTAKS

Workflow <Verb-Noun>
{
    Checkpoint-Workflow
}

Aktivitas Checkpoint-Workflow tidak menerima parameter apa pun, termasuk parameter umum dan parameter umum alur kerja.

Anda dapat menempatkan titik pemeriksaan Checkpoint-Activity di mana saja dalam alur kerja setelah pernyataan CmdletBinding atau Param. Namun, saat menempatkan titik pemeriksaan, pertimbangkan biaya performa mengumpulkan data dan menulisnya ke disk di komputer yang menjalankan alur kerja.

Pastikan bahwa waktu yang diperlukan untuk menjalankan ulang bagian alur kerja jika terganggu lebih besar dari waktu yang diperlukan untuk menulis status titik pemeriksaan dan data ke disk.

Pertimbangkan untuk mengambil titik pemeriksaan setelah langkah-langkah penting sehingga alur kerja dapat dilanjutkan daripada dimulai ulang. Misalnya, ambil titik pemeriksaan setelah perintah yang tidak idempotensi.

TENTANG TITIK PEMERIKSAAN

Titik pemeriksaan adalah rekam jepret dari status alur kerja saat ini, termasuk nilai variabel saat ini, dan output apa pun yang dihasilkan hingga titik itu, dan menyimpannya ke disk.

Jika alur kerja terganggu, sengaja atau tidak sengaja, Windows PowerShell Workflow secara otomatis menggunakan data di titik pemeriksaan terbaru untuk memulihkan dan melanjutkan alur kerja.

Saat Anda menjalankan alur kerja sebagai pekerjaan, seperti dengan menggunakan parameter umum alur kerja AsJob, titik pemeriksaan alur kerja dipertahankan hingga Anda menghapus pekerjaan, seperti dengan menggunakan cmdlet Remove-Job. Jika tidak, titik pemeriksaan alur kerja dihapus saat alur kerja selesai.

TEKNIK TITIK PEMERIKSAAN LAINNYA

Selain aktivitas Checkpoint-Workflow, Windows PowerShell Workflow mendukung teknik titik pemeriksaan lainnya, termasuk yang berikut ini:

  • Parameter umum alur kerja PSPersist
  • Parameter umum aktivitas PSPersist
  • Variabel PSPersistPreference (dalam alur kerja)

Untuk informasi selengkapnya tentang menambahkan titik pemeriksaan ke alur kerja, lihat "Cara Menambahkan Titik Pemeriksaan ke Alur Kerja."

Contoh

Alur kerja berikut menyertakan panggilan ke aktivitas Checkpoint-Workflow setelah menyelesaikan fungsi yang berjalan lama dan skrip yang berbagi data.

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

    Invoke-LongRunningFunction
    {
        ...
    }
}

Lihat Juga