Adaptations Windows

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.

Important : Pour que les tâches soient correctement configurées, les scripts doivent être enregistrés dans le répertoire UserScripts et les clés de registre mises à jour. La section suivante décrit comment effectuer facilement cette opération à l'aide d'un script d'assistance. Notez que seuls les scripts PowerShell peuvent être utilisés à cette fin.

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 :

1. Installez le module.
2. Téléchargez les scripts utilisateur PowerShell depuis la page Téléchargements.

3. Importez le module (utilisez le chemin d'accès approprié à votre déploiement) :

   Import-Module .\MigrateForGCEUserScripts.psm1 -force

4. 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.

     Remarque : Le script se trouve dans le répertoire UserScripts Velostrata. Si le script dépend d'autres fichiers, assurez-vous que les chemins d'accès à ces fichiers sont absolus ou copiez les fichiers dépendants dans le répertoire des scripts utilisateur.

   • 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.
     • Migrate for Compute Engine : 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
     Remarque : Le paramètre Platform est facultatif et est défini par défaut sur All.

5. 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 de scriptInstall.
   • 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