Adattamenti Windows

Panoramica

Per i sistemi Windows, Google Cloud Migrate for Compute Engine (in precedenza Velostrata) fornisce alcuni script di adattamento del sistema operativo per impostazione predefinita. Puoi anche fornire script aggiuntivi salvandoli in questa directory:

c:\Program Files\Velostrata\UserScripts

Il registro viene aggiornato in modo da eseguire gli script (noto anche come UserTasks) all'avvio, a seconda dell'ambiente in cui è in esecuzione la VM (noto anche come MachineState).

Le tre opzioni per MachineState sono:

  • Origin: gli script vengono eseguiti quando la VM si trova nell'ambiente on-premise
  • Velostrata: gli script vengono eseguiti quando la VM è in esecuzione in modalità memorizzata nella cache.
  • Detach: gli script vengono eseguiti dopo l'operazione di scollegamento.

Le attività vengono eseguite in ordine alfabetico. Se l'ordine delle attività è importante, utilizza prefissi numerici nei nomi delle attività, ad esempio 10_ResetWMI e 20_ConfigKMS. Assicurati di utilizzare percorsi assoluti nello script utente, poiché i percorsi relativi non verranno risolti correttamente.

Script di assistenza per PowerShell

Migrate for Compute Engine fornisce un modulo PowerShell che semplifica l'installazione dello script utente su una VM pertinente. Lo script convalida l'input utente per evitare stati incoerenti, copia lo script utente nella directory UserScripts e crea una struttura ad albero, se necessario. Il modulo PowerShell crea anche le chiavi di registro pertinenti e le relative strutture e compila i valori appropriati.

Nome modulo: VelostrataUserScripts.psm1

I comandi disponibili sono: Install-VelosUserScript e Remove-VelosUserScript

Per utilizzare lo script di assistenza:

  1. Installa il modulo.
  2. Scarica gli script utente di PowerShell dalla pagina Download.

  3. Importa il modulo (utilizza il percorso corretto per il deployment):

    Import-Module .\VelostrataUserScripts.psm1 -force

  4. Esegui lo script di assistenza per ogni script/attività di adattamento del sistema operativo che vuoi configurare. Ad esempio: 

    Install-VelosUserScript -FilePath .\resetWMI.ps1 -TaskName "10_ResetWMI" -MachineState Detach -TaskType RunAlways -Platform GCP
    dove:

    • FilePath è il nome file e il percorso dello script e può essere un percorso relativo o assoluto.

    • TaskName è un nome univoco che vuoi utilizzare per l'attività. Vedi la nota sulla sequenza riportata sopra.

    • MachineState è una delle tre opzioni seguenti:

      • Origin: ambiente on-premise.
      • Migrate for Compute Engine: gli script verranno eseguiti quando la VM è in esecuzione in modalità cache.
      • Detach: gli script verranno eseguiti dopo l'operazione di scollegamento.

    • TaskType è una delle seguenti opzioni:

      • RunOnce: l'attività verrà eseguita una volta all'avvio successivo e poi verrà eliminata.
      • RunAlways: l'attività viene eseguita a ogni avvio.

    • Piattaforma è uno dei seguenti ambienti in cui è in esecuzione la VM:

      • Aws
      • All

  5. Il comando di rimozione degli script convalida l'esistenza di un'attività, quindi la elimina dal registro e, facoltativamente, dalla directory degli script.

    Remove-VelosUserScript -TaskName "ResetWMI" -MachineState Detach -DeleteScriptFile

    dove:

    • TaskName è simile a quello fornito durante scriptInstall.
    • DeleteScriptFile è un parametro facoltativo. Esempi: 
      Install-VelosUserScript -FilePath .\KMS\Config-Kms_AWS.ps1 -TaskName "10_configKMS" -MachineState Velostrata -TaskType RunAlways
      Remove-VelosUserScript -TaskName "10_configKMS" -MachineState Velostrata -DeleteScriptFile