Présentation
Pour les systèmes Windows, Google Cloud Migrate for Compute Engine (anciennement Velostrata) fournit des scripts d'adaptation d'OS par défaut. Vous pouvez également fournir des scripts supplémentaires en les enregistrant dans le répertoire suivant :
c:\Program Files\Velostrata\UserScripts
Le registre est mis à jour pour exécuter les scripts au démarrage, (également appelés UserTasks
), selon l'environnement dans lequel la VM s'exécute. Ce processus est également appelé MachineState
.
Les trois options possibles pour MachineState
sont les suivantes :
Origin
: les scripts sont exécutés lorsque la VM se trouve dans l'environnement sur site.Velostrata
: les scripts sont exécutés lorsque la VM s'exécute en mode mis en cache.Detach
: les scripts sont exécutés après l'opération de dissociation.
Les tâches sont exécutées de manière séquentielle par ordre alphabétique. Si l'ordre des tâches est important, utilisez des préfixes numériques dans des noms des tâches, tels que 10_ResetWMI
et 20_ConfigKMS
. Assurez-vous d'utiliser des chemins d'accès absolus dans le script utilisateur, car les chemins d'accès relatifs ne seront pas résolus correctement.
Script d'assistance PowerShell
Migrate for Compute Engine fournit un module PowerShell qui simplifie l'installation de votre script utilisateur sur une VM pertinente. Le script valide les saisies de l'utilisateur pour éviter les incohérences d'état, copie le script utilisateur dans le répertoire UserScripts
et crée une arborescence si nécessaire. Le module PowerShell crée également les clés de registre pertinentes et leurs arborescences, et remplit les valeurs appropriées.
Nom du module : MigrateForGCEUserScripts.psm1
Les commandes disponibles sont : Install-VelosUserScript
et Remove-VelosUserScript
Pour utiliser le script d'assistance, procédez comme suit :
- Installez le module.
- Téléchargez les scripts utilisateur PowerShell depuis la page Téléchargements.
Importez le module (utilisez le chemin d'accès approprié à votre déploiement) :
Import-Module .\MigrateForGCEUserScripts.psm1 -force
Exécutez le script d'assistance pour chaque script ou tâche d'adaptation de l'OS que vous souhaitez configurer. Par exemple :
Install-VelosUserScript -FilePath .\resetWMI.ps1 -TaskName "10_ResetWMI" -MachineState Detach -TaskType RunAlways -Platform GCP
où :FilePath correspond au nom et au chemin d'accès du script. Il peut s'agir d'un chemin d'accès relatif ou absolu.
TaskName est un nom unique que vous souhaitez utiliser pour la tâche. Reportez-vous à la remarque relative au séquencement ci-dessus.
MachineState est associé à l'une des trois options suivantes :
Origin
: environnement sur site.Velostrata
: les scripts sont exécutés lorsque la VM s'exécute en mode mis cache.Detach
: les scripts seront exécutés après l'opération de dissociation.
TaskType est associé à l'une des options suivantes :
RunOnce
: cela signifie que la tâche sera exécutée une fois lors du prochain démarrage et qu'elle sera ensuite supprimée.RunAlways
: la tâche est exécutée à chaque démarrage.
La plate-forme correspond à l'un des environnements suivants dans lesquels la VM s'exécute :
Aws
All
La commande de suppression de script valide l'existence d'une tâche, puis la supprime du registre, et éventuellement du répertoire des scripts.
Remove-VelosUserScript -TaskName "ResetWMI" -MachineState Detach -DeleteScriptFile
où :
TaskName
est similaire à celui fourni lors descriptInstall
.DeleteScriptFile
est un paramètre facultatif. Exemples :Install-VelosUserScript -FilePath .\KMS\Config-Kms_AWS.ps1 -TaskName "10_configKMS" -MachineState Velostrata -TaskType RunAlways
Remove-VelosUserScript -TaskName "10_configKMS" -MachineState Velostrata -DeleteScriptFile