Zum Inhalt springen
Zurück zum Blog

Planner-Berichte mit PowerShell. Aus Aufgaben werden Entscheidungen.

Eine Liste mit zweihundert Aufgaben ist kein Bericht. Erst die Fragen, dann die Abfrage. Mit einem lesenden Skript, das mit Tasks.Read auskommt.

Microsoft 365SysadminProduktivität
Planner-Berichte mit PowerShell. Aus Aufgaben werden Entscheidungen.

Im Oktober 2024 habe ich ein Skript gezeigt, das die Planner-Aufgaben einer Teams-Gruppe als CSV exportiert. Der Artikel heißt PowerShell - Teams Planner Task Report.

Das Skript beantwortet die Frage, was in Planner steht. Im Jourfix wird eine andere Frage gestellt. Was müssen wir entscheiden?

Eine Liste mit zweihundert Aufgaben ist kein Bericht. Sie ist Rohmaterial.

Deshalb drehe ich die Reihenfolge heute um. Erst die Fragen, dann die Daten.

Fünf Fragen, bevor du PowerShell öffnest

Schreib auf, was der Bericht beantworten soll. Für eine Projekt- oder Teamübersicht sind es fast immer dieselben fünf Fragen.

  • Was ist überfällig? Dann wird nachgefragt, neu terminiert oder gestrichen.
  • Was hat niemand? Dann wird zugewiesen oder gestrichen.
  • Was hat keinen Termin? Dann bekommt es einen oder wandert sichtbar auf „irgendwann“.
  • Wer hat zu viel? Dann wird umverteilt.
  • Was wurde seit dem letzten Mal erledigt? Dann wird Fortschritt sichtbar.

Jede Frage führt zu einer Entscheidung. Eine Spalte, die zu keiner Frage gehört, fliegt raus.

Warum ich heute als Benutzer abfrage

Das Skript von 2024 arbeitet mit einer App-Registrierung, einem Secret und den Berechtigungen Group.Read.All und Tasks.Read.All. Das läuft, und für einen automatischen Lauf ohne angemeldeten Menschen ist es auch der richtige Weg.

Für den Bericht vor der Besprechung empfehle ich heute den schlankeren Weg, und zwar aus drei Gründen.

Weniger Berechtigung reicht. Um die Pläne einer Gruppe und die Aufgaben eines Plans zu lesen, genügt einer Anwendung Tasks.Read.All. Group.Read.All kannst du dir sparen. Nur wer zusätzlich Namen auflösen will, braucht User.Read.All.

Ein Secret ist ein Schlüssel. Eine App mit Tasks.Read.All liest alle Planner-Aufgaben im Tenant, ohne dass sich ein Mensch anmeldet. Wer das Secret hat, hat diesen Zugriff. Bleibst du beim App-Weg, braucht das Secret einen Besitzer, ein Ablaufdatum und einen sicheren Ablageort.

Delegiert passt besser zum Zweck. Meldest du dich als Benutzer an, reicht Tasks.Read, und das Skript sieht nur, was du selbst sehen darfst. Für einen Teambericht ist das genau richtig.

Das Skript

Du brauchst die Module Microsoft.Graph.Authentication und Microsoft.Graph.Planner sowie die Objekt-ID der Gruppe. Wo du die findest, steht im alten Artikel.

# Lesender Planner-Bericht für eine Microsoft-365-Gruppe
# Module: Microsoft.Graph.Authentication, Microsoft.Graph.Planner
Connect-MgGraph -Scopes 'Tasks.Read'

$gruppeId = '<Objekt-ID der Gruppe>'
$jetztUtc = (Get-Date).ToUniversalTime()   # Planner liefert Zeiten in UTC

$bericht = foreach ($plan in Get-MgGroupPlannerPlan -GroupId $gruppeId -All) {
    foreach ($aufgabe in Get-MgPlannerPlanTask -PlannerPlanId $plan.Id -All) {
        $zuweisungen = $aufgabe.Assignments.AdditionalProperties
        $zugewiesen  = if ($zuweisungen) { $zuweisungen.Count } else { 0 }
        $offen       = $aufgabe.PercentComplete -lt 100
        [PSCustomObject]@{
            Plan           = $plan.Title
            Aufgabe        = $aufgabe.Title
            Fortschritt    = $aufgabe.PercentComplete
            Faellig        = $aufgabe.DueDateTime
            Erledigt       = $aufgabe.CompletedDateTime
            AnzahlPersonen = $zugewiesen
            Ueberfaellig   = $offen -and $aufgabe.DueDateTime -and ($aufgabe.DueDateTime -lt $jetztUtc)
            OhnePerson     = $offen -and ($zugewiesen -eq 0)
            OhneTermin     = $offen -and (-not $aufgabe.DueDateTime)
        }
    }
}

$bericht | Export-Csv .\planner-bericht.csv -NoTypeInformation -Encoding UTF8 -Delimiter ';'

# Kurzauswertung für die Besprechung
[PSCustomObject]@{
    Aufgaben     = @($bericht).Count
    Offen        = @($bericht | Where-Object { $_.Fortschritt -lt 100 }).Count
    Ueberfaellig = @($bericht | Where-Object Ueberfaellig).Count
    OhnePerson   = @($bericht | Where-Object OhnePerson).Count
    OhneTermin   = @($bericht | Where-Object OhneTermin).Count
}

Das Skript nutzt nur Get--Befehle und ändert nichts. Eine Aufgabe gilt als erledigt, wenn PercentComplete bei 100 steht. Die Zuweisungen liefert Planner als offenes Objekt, in dem jede zugewiesene Person ein Eintrag mit ihrer Benutzer-ID ist. Deshalb zähle ich die Einträge in AdditionalProperties.

Lass es beim ersten Mal gegen eine Gruppe mit wenigen Aufgaben laufen und halte eine Aufgabe mit zwei zugewiesenen Personen daneben. Stimmt AnzahlPersonen dort, passt die Zählung. Dazu fünf Aufgaben als Stichprobe mit Planner vergleichen, also Fortschritt, Termin und Zuweisung.

Von der Zahl zur Entscheidung

Die Kurzauswertung liefert fünf Zahlen. Die allein sagen wenig. Der Bericht entsteht erst im zweiten Schritt, wenn du die CSV öffnest und sortierst.

Liegen fast alle überfälligen Aufgaben bei derselben Person, hast du kein Terminproblem, sondern ein Lastproblem. Auf die Tagesordnung gehört dann die Frage, ob umverteilt oder verschoben wird.

Stammen die Aufgaben ohne Person alle aus derselben Besprechung, wurde dort mitgeschrieben, aber nichts verteilt. Die nächste Sitzung weist sie zu oder streicht sie.

Sind die Aufgaben ohne Termin überwiegend Ideen für später, gehören sie in einen eigenen Bucket „Später“. Dann verzerren sie den Bericht nicht mehr.

Aus drei Zahlen werden so drei Punkte für die Tagesordnung. Das ist der Bericht. Die CSV ist nur der Anhang.

Worauf du achten solltest

  • Premium-Pläne fehlen. Über Microsoft Graph erreichst du nur Basispläne. Nutzt ihr Premium-Pläne, tauchen sie im Bericht nicht auf.
  • Du siehst nur deine Pläne. Fehlt ein Plan, hat die angemeldete Person keinen Zugriff darauf.
  • Zeiten sind UTC. Eine Aufgabe, die heute fällig ist, kann je nach Uhrzeit schon als überfällig erscheinen. Für die Tagesübersicht reicht das.
  • Keine Namen, mit Absicht. Das Skript zählt Zuweisungen und löst keine Personen auf. Das spart eine Berechtigung und hält personenbezogene Daten aus dem Export.
  • Auswertung je Person vorher klären. Sobald du Last pro Kopf auswertest, ist das keine technische Frage mehr. Hast du einen Betriebsrat, gehört er vorher an den Tisch.
  • Der Bericht ist eine Momentaufnahme. Für „seit dem letzten Mal“ hebst du die vorige CSV auf und vergleichst.

Und leg die CSV dort ab, wo nur die Leute Zugriff haben, die auch den Plan sehen dürfen.

Mit welcher Frage geht ihr in euer nächstes Jourfix?

Gruß Micha

Zum Nachlesen

Hat dir der Artikel geholfen? Teile ihn mit deinem Netzwerk.

LinkedIn X