Adaptações do Windows

Visão geral

Para os sistemas Windows, o Google Cloud Migrate for Compute Engine (antigo Velostrata) fornece alguns scripts de adaptação do SO por padrão. Também é possível fornecer scripts adicionais salvando-os neste diretório:

c:\Program Files\Velostrata\UserScripts

O registro é atualizado para executar os scripts (também conhecidos como UserTasks) na inicialização, dependendo do ambiente em que a VM está em execução (também conhecida como MachineState).

Confira a seguir as três opções de MachineState:

  • Origin: os scripts são executados quando a VM está no ambiente local.
  • Velostrata - os scripts são executados quando a VM está em execução no modo cache.
  • Detach: os scripts são executados após a operação de desanexação.

As tarefas são executadas sequencialmente em ordem alfabética. Se a ordem das tarefas for importante, use prefixos numéricos nos nomes das tarefas, como 10_ResetWMI e 20_ConfigKMS. Certifique-se de usar caminhos absolutos no script do usuário porque os caminhos relativos não serão resolvidos corretamente.

Script de assistência do PowerShell

O Migrate for Compute Engine fornece um módulo do PowerShell que simplifica a instalação de seu script de usuário em uma VM relevante. O script valida a entrada do usuário para evitar estados inconsistentes, copia o script de usuário para o diretório UserScripts e, se necessário, cria uma árvore. O módulo do PowerShell também cria as chaves de registro relevantes e suas respectivas árvores e preenche os valores apropriados.

Nome do módulo: MigrateForGCEUserScripts.psm1

Os comandos disponíveis são: Install-VelosUserScript e Remove-VelosUserScript

Para usar o script de assistência, siga estas instruções:

  1. Instale o módulo.
  2. Faça o download dos scripts de usuário do PowerShell na página de downloads.
  3. Importe o módulo (use o caminho correto para a implantação):

    Import-Module .\MigrateForGCEUserScripts.psm1 -force

  4. Execute o script de assistência para cada script do OS que você quer configurar. Por exemplo:

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

    • FilePath é o caminho e o nome de arquivo do script. Além disso, ele pode ser um caminho absoluto ou relativo.

    • TaskName é um nome único que você quer usar para a tarefa. Veja a observação sobre o sequenciamento acima.

    • MachineState é uma das três opções a seguir:

      • Origin: ambiente local.
      • Migrate for Compute Engine - os scripts serão executados quando a VM estiver em execução no modo cache.
      • Detach: os scripts serão executados após a operação de desanexação.
    • TaskType é uma das seguintes opções:

      • RunOnce: isso significa que a tarefa será executada uma vez na próxima inicialização e excluída em seguida.
      • RunAlways: a tarefa é executada a cada inicialização.
    • Plataform é um dos seguintes ambientes em que a VM está em execução:

      • Aws
      • All
  5. O comando de remoção de script valida a existência de uma tarefa e a exclui do registro em seguida. Além disso, é possível fazer com que o comando exclua a tarefa do diretório de scripts também.

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

    em que:

    • TaskName é semelhante ao fornecido durante scriptInstall.
    • DeleteScriptFile é um parâmetro opcional. Exemplos:
      Install-VelosUserScript -FilePath .\KMS\Config-Kms_AWS.ps1 -TaskName "10_configKMS" -MachineState Velostrata -TaskType RunAlways
      Remove-VelosUserScript -TaskName "10_configKMS" -MachineState Velostrata -DeleteScriptFile