Übersicht
Bei Windows-Systemen stellt Google Cloud Migrate for Compute Engine (ehemals Velostrata) standardmäßig einige Skripts zur Anpassung des Betriebssystems bereit. Sie können aber auch zusätzliche Skripts bereitstellen. Speichern Sie sie dazu in diesem Verzeichnis:
c:\Program Files\Velostrata\UserScripts
Die Registry wird dann aktualisiert, um die Skripts (auch bekannt als UserTasks
) beim Start abhängig von der Umgebung auszuführen, in der die VM ausgeführt wird (auch bekannt als MachineState
).
Für MachineState
sind drei Optionen vorhanden:
Origin
: Die Skripts werden ausgeführt, wenn sich die VM in der lokalen Umgebung befindet.Velostrata
: Die Skripts werden ausgeführt, wenn die VM im Cache-Modus ausgeführt wird.Detach
: Die Skripts werden nach der Trennung ausgeführt.
Die Aufgaben werden nacheinander in alphabetischer Reihenfolge ausgeführt. Wenn die Reihenfolge der Aufgaben wichtig ist, verwenden Sie numerische Präfixe in den Aufgabennamen, z. B. 10_ResetWMI
und 20_ConfigKMS
. Achten Sie darauf, absolute Pfade im Nutzerskript zu verwenden, da relative nicht korrekt aufgelöst werden können.
PowerShell-Hilfeskripts
Migration for Compute Engine stellt ein PowerShell-Modul zur Verfügung, das die Installation Ihres Nutzerskripts auf einer relevanten VM vereinfacht. Das Skript validiert Nutzereingaben, um inkonsistente Zustände zu verhindern, kopiert das Nutzerskript in das Verzeichnis UserScripts
und erstellt bei Bedarf eine Baumstruktur. Das PowerShell-Modul erstellt auch die relevanten Registrierungsschlüssel und deren Baumstrukturen und liefert die entsprechenden Werte.
Modulname: MigrateForGCEUserScripts.psm1
Verfügbare Befehle: Install-VelosUserScript
und Remove-VelosUserScript
So verwenden Sie das Hilfeskript:
- Modul installieren
- Laden Sie die PowerShell-Benutzerskripts von der Downloadseite herunter.
Importieren Sie das Modul und verwenden Sie dabei den korrekten Pfad für die Bereitstellung:
Import-Module .\MigrateForGCEUserScripts.psm1 -force
Führen Sie das Hilfeskript für jedes Betriebssystemanpassungsskript oder jede zu konfigurierende Aufgabe aus. Beispiel:
Install-VelosUserScript -FilePath .\resetWMI.ps1 -TaskName "10_ResetWMI" -MachineState Detach -TaskType RunAlways -Platform GCP
Dabei gilt:FilePath ist der Dateiname und Pfad des Skripts. Dies kann entweder ein relativer oder ein absoluter Pfad sein.
TaskName ist ein eindeutiger Name, den Sie für die Aufgabe verwenden möchten. Lesen Sie oben den Hinweis zur Sequenzierung.
MachineState ist eine der folgenden drei Optionen:
Origin
: Lokale Umgebung.Migrate for Compute Engine
: Die Skripts werden ausgeführt, wenn die VM im Cache-Modus ausgeführt wird.Detach
: Die Skripts werden nach der Trennung ausgeführt.
TaskType ist eine der folgenden Optionen:
RunOnce
: Die Aufgabe wird beim nächsten Startvorgang einmal ausgeführt und dann gelöscht.RunAlways
: Die Aufgabe wird bei jedem Start ausgeführt.
Platform ist eine der folgenden Umgebungen, in denen die VM ausgeführt wird:
Aws
All
Der Befehl zur Skriptentfernung prüft, ob eine Aufgabe vorhanden ist, und löscht sie dann gegebenenfalls aus der Registry sowie optional aus dem Skriptverzeichnis.
Remove-VelosUserScript -TaskName "ResetWMI" -MachineState Detach -DeleteScriptFile
Dabei gilt:
TaskName
entspricht dem Parameter, der währendscriptInstall
bereitgestellt wird.DeleteScriptFile
ist ein optionaler Parameter. Beispiele:Install-VelosUserScript -FilePath .\KMS\Config-Kms_AWS.ps1 -TaskName "10_configKMS" -MachineState Velostrata -TaskType RunAlways
Remove-VelosUserScript -TaskName "10_configKMS" -MachineState Velostrata -DeleteScriptFile