Windows 11 Release Guard

Configuration

Use this when choosing runtime defaults or documenting CLI/env knobs for fleet usage.


ContextDefault
Human local check--pretty
RMM compliance--json --no-wua
Production compliance--strict-production --json --no-wua
Troubleshooting update offersAdd --wua
Source-only verification--check-policy-source and --check-public-pages

Settings / Knobs

KnobSourceMeaning
--policy-urlCLIOverride default policy URL or use local file.
WIN11_RELEASE_GUARD_POLICY_URLEnvDefault policy URL override.
--strict-productionCLIRequire live signed remote JSON for production-green result.
WIN11_RELEASE_GUARD_STRICT_PRODUCTIONEnvEnable strict-production preset.
--cache-fileCLIOverride cache path.
--cache-max-age-hoursCLIFresh cache age.
--stale-cache-max-age-hoursCLIStale cache allowance.
--max-policy-bytesCLI/envPolicy fetch/parse size cap.
--wua / --no-wuaCLIEnable or disable optional WUA probe.
--include-raw-local-diagnosticsCLIInclude raw bounded local Panther/setup log tails instead of default JSON compaction.
--quality-policyCLIChoose B-release default or broader quality policy.

Runtime Clamps / Fallbacks

AreaDefault behavior
HTTP fetchBounded timeout and byte cap.
WUA subprocessBounded timeout.
DISM / PowerShell probesBounded timeouts.
Panther logsFixed known paths, bounded per-file tail reads, a generous global collection guard, and default JSON compaction unless --include-raw-local-diagnostics is used.
WUA outputHistory and relevant OS update lists are bounded.
Cache fallbackVisible degraded source status.

Panther/setup logs are administrator troubleshooting evidence only. They do not decide compliance or override the signed public policy verdict.

Deprecated / Avoid

AvoidReason
--allow-unsigned-policy in productionRemoves signature trust requirement.
Runtime HTML fallbackGenerator owns Microsoft HTML parsing.
Treating stale cache as production-greenStrict-production blocks this.

Verify

python -m win11_release_guard --diagnose-config
pytest -q tests/test_cache.py tests/test_cli.py

Home | CLI and RMM Usage | Policy Feed and Trust Model