Você está visualizando a documentação de uma versão anterior do Migrate for Compute Engine (antigo Velostrata). Você escolhe se quer continuar usando esta versão ou usar a versão atual.

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: VelostrataUserScripts.psm1

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

Para usar o script de assistência:

Instale o módulo.
Faça o download dos scripts de usuário do PowerShell na página Downloads.
Importe o módulo (use o caminho correto para a implantação):
```
Import-Module .\VelostrataUserScripts.psm1 -force
```
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.
  
  Observação: o script fica no diretório UserScripts do Velostrata. Se o script depender de outros arquivos, certifique-se de que os caminhos para esses arquivos sejam absolutos ou copie os arquivos dependentes para o diretório de scripts de usuário.
- 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
  Observação: o parâmetro Plataform é opcional e tem All como padrão.
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
```