# Windows PowerShell5.1: feste prozessbezogene RemoteSigned-Option Stand2026-11-14, Spezifikation1.18. **Userentscheidung als Sourcekandidat im isolierten Profilbranch umgesetzt und nativ Linux-first vertraglich geprüft.** Die23 Domain-/Coreverträge bestanden auf der Cloud-Linux-VM; Windows22 und die tatsächliche genehmigte PowerShellwirkung bleiben offen. Keine Capability-, Clock- oder Jobkonfiguration aktiviert, kein Deployment. Hauptcheckout und laufende Windowsartefakte bleiben unverändert. [Tatsächlicher Nachweis](windows-profile-acceptance.md). ## Autorisierter Umfang Der User erlaubt die feste Option `RemoteSigned` für jeden zuvor mit seinem unveränderlichen Plan in der WebUI genehmigten Windows-PowerShell5.1-Jobprozess. Der Prozessumfang und die Option müssen bereits vor der Genehmigung sichtbar und Bestandteil der signierten Originaljobbytes sein. Das erlaubt keine pauschale Skriptfreigabe, keinen direkten API-/DB-Genehmigungspfad, keine freie Policyzeichenfolge und keine SYSTEM-/Root-PowerShell. Der erste SYSTEM-Vertrag bleibt auf seine eigenen typisierten SCM-Fixturen begrenzt. Der Executor setzt dafür keine CurrentUser-/LocalMachine-/GPO-Werte, schreibt keine Registryrichtlinie und verwendet kein `Bypass`/`Unrestricted`. Eine Gruppenrichtlinie wird nicht verändert oder übergangen. Blockiert sie den Auftrag weiterhin, wird der tatsächliche Fehler berichtet. Microsoft beschreibt den Hostparameter als sitzungsbezogen und ohne Registryänderung; Gruppenrichtlinien bleiben vorrangig. [Windows-PowerShell5.1-CLI](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_powershell_exe?view=powershell-5.1), [Policybereiche und Vorrang](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies?view=powershell-5.1). ## Kleinster vorgeschlagener Datenvertrag Ein optionales, am Ende ergänztes Feld `windows_execution_profile` in `Action::RunScript` enthält eine endliche typisierte Enum mit zunächst genau `powershell_51_remote_signed`. Das ist ein technischer Vorschlag zur Prüfung, noch kein vorhandenes Schema. Der Wert bezeichnet fest Windows PowerShell5.1, `agent_service` und RemoteSigned im Jobprozess; kein frei übergebbarer Interpreterpfad, Scope oder CLI-Argumentblock. Das fehlende Feld behält die vorhandene Bedeutung `inherited`. Es wird per Serde-default und `skip_serializing_if = Option::is_none` beim Kodieren vollständig ausgelassen. Damit bleiben bisherige Linux-/PowerShell-Job- und Plangoldens bytegleich; vorhandene Pläne erhalten nachträglich keine neue Prozessoption. Die zusätzlichen Bytes eines neuen RemoteSigned-Auftrags gehen bereits in `job_payload_hash`, Planhash und den bisherigen signierten Originalgrant ein. Ein neuer Grantcodec oder ein neues pauschales Genehmigungsrecht ist dafür nicht nötig. Geänderter Profilwert bedeutet geänderten Plan mit neuer WebUI-Genehmigung, niemals nachträgliche Anpassung des genehmigten Payloads. Nur `interpreter=powershell`, `execution_identity=agent_service`, ein eindeutig gemeldetes Windowsziel und die konkrete qualifizierte Profilfähigkeit dürfen den Wert verwenden. Linux, posix_sh/bash, andere Interpreter, gemischte Plattformcapabilities, Root/SYSTEM und unbekannte Profilwerte verweigern ihn. Ein gesonderter Profilcapabilityname, beispielsweise `script.powershell.process_remote_signed/1`, ergänzt `script.powershell/1`; alte Windowsclients erhalten dadurch keinen unbekannten Auftrag. Die Benennung und Veröffentlichung bleiben bis Review und tatsächlicher Qualifikation offen. ## Konkreter Änderungsschnitt nach Freigabe der Quellen | Quelle | Eng erforderliche spätere Änderung | | --- | --- | | `crates/domain/src/jobs.rs` | Option/Enum, validate/available_for und unveränderte Legacygoldens. Nicht-Windows-/Nicht-PowerShell-Verwendung früh verweigern. Bestehende Konstruktoren erhalten ausdrücklich None ohne Wireänderung. | | `crates/server/src/jobs.rs` | Feld je `Variant` mitführen: Web-resolve, validate_variants, target_action und Erstvarianten-Konsistenz einschließlich Profil. Gemischte feste Pläne binden das Profil ausschließlich in der Windowsvariante. Typed- und Webeingang gleich prüfen. Vorhandene Submit-/Approval-/Revalidationpfade behalten Hash- und Rechteprüfung. | | `crates/server/src/job_gateway.rs`, `crates/server/src/synchronization.rs` | Vorhandene zentrale Capability-/Payloadprüfung für Zustellung und Permit prüfen; Erfolgsevidenz bindet angefordertes Profil und Prozessumfang, behauptet ohne Messbeleg keine effektive GPO-Policy. Keine Abschwächung der Grant-, Sync- oder Clockprüfungen. | | `web/src/api.ts`, `web/src/safety.ts`, `web/src/main.tsx` | Eingabe nur als festes Windowsprofil; keine beliebigen Policyflags. Vor dem Genehmigungsknopf aus hashgeprüften gespeicherten Planbytes je Windowsziel ausdrücklich „Windows PowerShell5.1 · RemoteSigned · nur Jobprozess“ anzeigen. Fehlender/unlesbarer Profil-/Plannachweis blockiert die entsprechende Genehmigung. Alte inherited-Pläne ehrlich als solche zeigen. | | `crates/agent-windows/src/actions.rs` | Profil prüfen und ausschließlich beim passenden signierten Auftrag `-ExecutionPolicy RemoteSigned` vor `-File` in die festen Einzelargumente aufnehmen. None behält vorhandene inherited-Argumente. Kein Wrapper, keine Prolog-/BOM-/Zeilenendenänderung und keine andere Skriptkopie nach Hashbildung. Evidenz nennt angefordertes Profil/Prozessumfang. | | `crates/agent-windows/src/runtime.rs` | Neue Profilcapability erst nach separater nativer Clock-/Boot-/Jobpfadqualifikation veröffentlichen. Kein Aktivieren durch den bloßen Codec-/Buildwechsel. | Der vorhandene Prozessadapter nutzt bereits einen festen ausführbaren Pfad, ein minimales eigenes Childenvironment sowie atomare Job-/Handlelisten und begrenzte stdout/stderr-/Timeout-/Cancelpfade. Diese Verträge bleiben erhalten. Es wird kein Policywert in die Umgebung des permanenten Agentdiensts übernommen. Nach `-File` folgen ausschließlich die genehmigten Skriptargumente. Eine angeforderte Prozesspolicy ist keine Behauptung der tatsächlich effektiven Policy; bei Bedarf enthält eine separat genehmigte harmlose Abnahme selbst die unveränderten read-only Get-ExecutionPolicy-Anweisungen als sichtbare Skriptbytes. Kein stiller Zusatzprozess oder Scriptwrapper zur Liveerhebung. ## Geplante minimale Nachweise, nicht ausgeführt 1. Shared Domain-/Grantvertrag lokal prüfen: alte Linux-/PowerShell-Goldens bytegleich; neues Profil vollständig im Payload-/Planhash; Profilmutation gegen den Originalgrant verweigert; Linux/anderer Interpreter/Root/SYSTEM/ unbekannter Wert/fehlende Profilcapability verweigert. Gemischter Plan behält die unveränderte Linuxvariante und die feste Windowsprofilbindung. 2. Diese gemeinsam betroffenen Vertrags-/Negativfälle zuerst isoliert auf der tatsächlichen Linux-Test-VM ausführen. Keine tatsächliche Windowsausführung oder zusätzlich genehmigte Zielwirkung damit vortäuschen. Vorhandene Linux- Jobhistorie/Grants und Jobzahlen bleiben unverändert; ein Crossbuild ersetzt diesen Linux-first-Nachweis nicht. 3. Server-/UI-Negativfälle eng prüfen: Option im verifizierten Approvalplan sichtbar; Mutation, Capabilityverlust und Widerspruch zwischen Variant und Action verweigert; pending_approval ohne Job/Outbox/Startgrant. Kein API-/DB- Approval als Testabkürzung. 4. Erst nach den separaten Clock-/Boot-/Jobgates auf der tatsächlichen Windows- VM einen neuen festen harmlosen PowerShellplan in der WebUI genehmigen. Prozess, SID, exakte Skript-/Ausgabebytes und angeforderte Option nachweisen. Falls effektive Policy geprüft wird, stehen diese read-only Befehle bereits im genehmigten Skript. Persistente CurrentUser-/Maschinen-/GPO-Werte vor/nach der Abnahme unabhängig lesen und unverändert nachweisen. Kein Reboot für diesen Skripttest, keine Maschinenpolicyänderung und keine neue Wirkung bei Redelivery. Browser-Dev/Testsimulation nur sichtbar nach bestehendem Vertrag. Der bestehende W32Time darf nach neuer Userfreigabe ohne Startart-/NTP-/ACLänderung gezielt gestartet werden. Ein späterer manueller VM-Konsolenneustart benötigt vorher die konkrete Zeitabstimmung mit dem User und ist kein RMM-Reboottest. Beides ist ein separater Umfang und ersetzt weder eine vertrauenswürdige Uhr noch die WebUI-Genehmigung eines Skriptjobs.