- Dokumentation
- WuInstall
Filter-Optionen
/classification <codes>
Filtert die Ergebnisse nach Update-Klassifizierung. Kombinieren Sie die Buchstabencodes beliebig, um mehrere Klassifizierungen auszuwählen:
| Code | Klassifizierung | Beschreibung |
|---|---|---|
C |
Kritische Updates | Allgemein veröffentlichte Korrekturen für kritische, nicht sicherheitsrelevante Fehler |
U |
Updates | Allgemein veröffentlichte Korrekturen für nicht kritische, nicht sicherheitsrelevante Fehler |
R |
Updaterollups | Kumulative Pakete aus Hotfixes, Sicherheitsupdates und kritischen Updates |
S |
Sicherheitsupdates | Allgemein veröffentlichte Korrekturen für Sicherheitslücken |
E |
Service Packs | Kumulative Sammlungen aller Updates seit der Veröffentlichung des Produkts, können Designänderungen enthalten |
F |
Feature Packs | Neue Funktionen, die in der Regel in die nächste Produktversion übernommen werden |
D |
Definitionsupdates | Updates von Viren- oder anderen Definitionsdateien |
A |
Upgrades | Größere Betriebssystem-Upgrades (z. B. Windows 11 22H2) |
wuinstall /search /criteria "IsInstalled=1" /classification CRSE
/severity <codes>
Filtert die Ergebnisse nach Schweregrad. Gilt nur für Sicherheitsupdates – nicht sicherheitsrelevante Updates haben den Schweregrad Unknown. Kombinieren Sie die Buchstabencodes, um mehrere Stufen auszuwählen:
| Code | Schweregrad | Beschreibung |
|---|---|---|
C |
Kritisch | Ohne Benutzeraktion ausnutzbar (z. B. wurmfähige Sicherheitslücken) |
I |
Hoch | Risiko für Vertraulichkeit, Integrität oder Verfügbarkeit von Daten |
M |
Mittel | Auswirkung durch die Standardkonfiguration oder die schwierige Ausnutzbarkeit deutlich verringert |
L |
Niedrig | Äußerst schwer auszunutzen oder minimale Auswirkung |
U |
Unbekannt | Alle nicht sicherheitsrelevanten Updates |
wuinstall /search /severity CIU – kritisch, hoch und unbekannt
/product "product_name"
Beschränkt die Ergebnisse auf ein bestimmtes Produkt. Der Produktname muss exakt übereinstimmen, einschließlich Groß-/Kleinschreibung – Platzhalter sind nicht möglich. Pro Aufruf kann nur ein Produkt angegeben werden.
wuinstall /search /criteria "IsInstalled=1" /product "Forefront Client Security"
/noproduct "product_name"
Umkehrung von /product – schließt alle Updates des angegebenen Produkts aus. Kombinieren Sie den Schalter nicht mit /product: Beide Schalter teilen sich einen Wert, daher wählt die Kombination keine Updates aus. WuInstall 2.9.x akzeptiert nur die Schreibweise /notproduct (/noproduct liefert dort Exit-Code 7); WuInstall 3 akzeptiert beide.
/match "string|regex"
Berücksichtigt nur Updates, deren Titel oder Update-ID auf die angegebene Zeichenfolge passt (Groß-/Kleinschreibung wird beachtet). Vollständige reguläre Ausdrücke werden unterstützt. Ab WuInstall 3.0.4 ist ein Muster, das kein gültiger regulärer Ausdruck ist (zum Beispiel mit einer nicht geschlossenen Klammer), ein Syntaxfehler (Exit-Code 7), auch bei /nomatch; frühere Versionen behandelten es, als passe es auf nichts, sodass ein fehlerhaftes /nomatch-Muster nichts ausschloss.
wuinstall /search /match "KB890830"wuinstall /search /match "(Language|KB93|Internet Explorer)"– Regex-ODER
/nomatch "string|regex"
Umkehrung von /match – schließt Updates aus, deren Titel oder Update-ID auf die angegebene Zeichenfolge oder das angegebene Muster passt. Geben Sie den Schalter nur einmal an und fassen Sie mehrere Begriffe in einem Muster zusammen ("Preview|Feature update"): Ein doppelt angegebener Schalter ist in WuInstall 2.9.x und ab 3.0.4 ein Syntaxfehler (Exit-Code 7), während 3.0.0 bis 3.0.3 nur den letzten verwendeten. Lässt sich mit /match kombinieren:
wuinstall /search /match "(SQL|Office)" /nomatch "Service Pack"
Eine Referenz zu regulären Ausdrücken finden Sie in dieser Anleitung.
/matchfile <path>
Wendet mehrere Match-Ausdrücke aus einer Datei an (einen pro Zeile). Ein Update wird berücksichtigt, wenn sein Titel oder seine Update-ID auf mindestens einen Eintrag passt. Reguläre Ausdrücke werden unterstützt. Text nach # ist ein Kommentar; nach einer Zeile #nocase werden die Einträge ohne Beachtung der Groß-/Kleinschreibung verglichen (schreiben Sie sie in Kleinbuchstaben), bis eine Zeile #case folgt. Existiert die Datei nicht, wird kein Update ausgewählt (Exit-Code 3).
# C:\updateList.txt
KB963671
KB975467
.NET Framework 3.5 SP1 Security
Security State Assessment 1.0
wuinstall /search /matchfile "C:\updateList.txt"
Nützlich, um eine zentrale Rollout-Liste auf einem gemeinsamen Netzlaufwerk zu pflegen. Unterstützte Kodierungen: UTF-8 und ANSI. WuInstall 3 liest außerdem UTF-16- und UTF-32-Dateien mit Byte Order Mark. WuInstall 2.9.x unterstützt kein UTF-16, und Einträge mit Nicht-ASCII-Zeichen (z. B. Umlauten) passen dort nur, wenn die Datei als ANSI gespeichert ist.
/nomatchfile <path>
Umkehrung von /matchfile – schließt jedes Update aus, das auf mindestens einen Eintrag in der Datei passt. Existiert die Datei nicht, wird überhaupt kein Update ausgewählt – ab WuInstall 3.0.4 auch dann, wenn eine Zeile darin kein gültiger regulärer Ausdruck ist (die Logdatei nennt die Datei).
wuinstall /search /nomatchfile "C:\exclude.txt"
/isdownloaded 1|0
Filtert nach dem Status im lokalen Cache. Mit /isdownloaded 1 installieren Sie nur Updates, die bereits im lokalen Cache vorhanden sind:
wuinstall /install /isdownloaded 1
Hinweis: Wenn Sie Dateien manuell aus
Windows\SoftwareDistribution\Downloadlöschen, kann sich dieser Filter unerwartet verhalten – gelöschte Updates werden möglicherweise weiterhin als heruntergeladen gemeldet.
/releasedate [lt|eq|gt]:<YYYY-MM-DD> oder /releasedate <+/-Days>
Filtert Updates nach Veröffentlichungsdatum. Ein ungültiger Wert wird ignoriert, es wird dann also kein Datumsfilter angewendet. WuInstall 3 akzeptiert auch die Schreibweise /release_date (WuInstall 2.9.x liefert dafür Exit-Code 7). Zwei Verwendungsarten:
Absolutes Datum:
wuinstall /search /releasedate lt:2022-05-06– veröffentlicht vor dem 6. Mai 2022wuinstall /search /releasedate gt:2022-01-01– veröffentlicht nach dem 1. Januar 2022
Relative Tage:
wuinstall /search /releasedate +10– Updates, die mindestens 10 Tage alt sindwuinstall /search /releasedate -10– Updates, die in den letzten 10 Tagen veröffentlicht wurden
/maxUpdateCount <number>
Begrenzt die Anzahl der Updates, die in einem einzelnen WuInstall-Aufruf verarbeitet werden. Sind mehr Updates verfügbar als das angegebene Limit, werden nur die ersten n verarbeitet.
/updateSize [lt|gt]:<size> or bt:<min>-<max>
Filtert Updates nach Downloadgröße. Unterstützte Einheiten: KB, MB, GB. Ein ungültiger Wert ist ein Syntaxfehler (Exit-Code 7).
wuinstall /search /updateSize lt:50MB– kleiner als 50 MBwuinstall /search /updateSize bt:10MB-200MB– zwischen 10 MB und 200 MB
/maxTotalSize <size>
Legt eine Obergrenze für die Gesamtgröße (z. B. 500MB) aller Updates in der Ergebnisliste fest; /maxPayload ist ein Alias. WuInstall durchläuft die Liste und nimmt keine weiteren Updates mehr auf, sobald die aufsummierte Größe das Limit überschreitet.
/query_history
Hängt einen vollständigen Verlauf der bisher installierten Updates an die XML-Ausgabedatei an. Wirkt nur, wenn auch /xmlout (oder /info) angegeben ist, und nur zusammen mit /search, /download oder /install. Der JSON-Bericht von /jsonout (WuInstall 3) enthält den Verlauf nicht.