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