In der vorigen Lektion haben Sie gelernt, jede einzelne Änderung hinter eine Frage zu stellen. Ein Runbook ist mehr als eine Änderung: Es ist ein Ablauf, den jemand heute, morgen und nach einem Absturz noch einmal startet. Dafür muss er zwei Eigenschaften haben. Er muss vorher zeigen, was er tut (-WhatIf), und er darf nur tun, was noch zu tun ist. Die zweite Eigenschaft heißt Idempotenz, und sie macht aus einem Skript, vor dem man Angst hat, eines, das man wiederholen darf.

Alle Beispiele dieser Lektion wurden mit PowerShell 7.6.9 auf Windows 11 ausgeführt, das native Programm ist git (Ausgaben aus diesem Lauf, Pfad gekürzt). Das Übungsverzeichnis heißt office. Ein REST-Beispiel läuft gegen einen kleinen Server, den das Beispiel selbst auf dem eigenen Rechner startet; es berührt kein Netz.

Idempotent: das Wort und die Sache

Eine Operation ist idempotent, wenn sie nach dem zweiten Ausführen denselben Zustand hinterlässt wie nach dem ersten. „Lege den Ordner archive an“ ist es nicht (der zweite Aufruf scheitert oder legt etwas Neues an). „Sorge dafür, dass der Ordner archive existiert“ ist es. Der Unterschied liegt im Wort: Ein idempotentes Runbook beschreibt einen Sollzustand, nicht eine Folge von Schritten.

Das Muster dafür hat drei Teile: lesen (was ist da?), vergleichen (was fehlt, was ist zu viel, was ist falsch?), ändern (nur den Unterschied). Der Lohn: Ein Lauf nach einem Absturz macht dort weiter, wo er aufgehört hat, ein Lauf ohne Änderungsbedarf tut nichts, und die Vorschau ist genau, weil Lesen und Vergleichen auch bei -WhatIf wirklich laufen.