Configurar o agente do EC2Launch v1 na instância do Windows
Quando a instância tiver sido inicializada pela primeira vez, é possível configurar o EC2Launch para iniciar novamente e executar diferentes tarefas de startup.
Tarefas
Configurar as tarefas de inicialização
Especifique as configurações no arquivo LaunchConfig.json
para ativar ou desativar as seguintes tarefas de inicialização:
-
Defina o nome do computador para o endereço IPv4 privado da instância.
-
Defina o monitor para ficar sempre ligado.
-
Configurar novo papel de parede.
-
Adicionar a lista de sufixos DNS.
nota
Isso adiciona uma pesquisa de sufixo DNS para o domínio apresentado a seguir e configura outros sufixos padrão. Para obter mais informações sobre como os agentes de inicialização definem os sufixos DNS, consulte Configurar o sufixo DNS para agentes de execução do EC2 Windows.
region
.ec2-utilities.amazonaws.com -
Estender o tamanho do volume de inicialização.
-
Defina a senha de administrador.
Para definir as configurações de inicialização
-
Na instância a ser configurada, abra o seguinte arquivo em um editor de texto:
C:\ProgramData\Amazon\EC2-Windows\Launch\Config\LaunchConfig.json
. -
Atualize as seguintes configurações conforme necessário e salve suas alterações. Forneça uma senha em
adminPassword
somente seadminPasswordtype
forSpecify
.{ "setComputerName": false, "setMonitorAlwaysOn": true, "setWallpaper": true, "addDnsSuffixList": true, "extendBootVolumeSize": true, "handleUserData": true, "adminPasswordType": "Random | Specify | DoNothing", "adminPassword": "password that adheres to your security policy (optional)" }
Os tipos de senha são definidos da seguinte maneira:
Random
-
O EC2Launch gera uma senha e criptografa-a usando a chave de usuário. O sistema desativa essa configuração depois da execução da instância, portanto, essa senha persistirá se a instância for reinicializada ou parada e iniciada.
Specify
-
O EC2Launch usa a senha que você especifica
adminPassword
. Se a senha não atender aos requisitos de sistema, o EC2Launch gera uma senha aleatória. A senha é armazenada emLaunchConfig.json
como texto não criptografado e será excluída depois que Sysprep definir a senha do administrador. O EC2Launch criptografa a senha usando a chave de usuário. DoNothing
-
O EC2Launch usa a senha que você especifica o arquivo
unattend.xml
. Se você não especificar uma senha emunattend.xml
, a conta de administrador ficará desativada.
-
No Windows PowerShell, execute o seguinte comando para programar a execução do script como uma tarefa agendada do Windows. O script é executado uma vez durante a próxima inicialização e desativa essas tarefas para que não sejam executadas novamente.
C:\ProgramData\Amazon\EC2-Windows\Launch\Scripts\InitializeInstance.ps1 -Schedule
Programar o EC2Launch para ser executado em cada inicialização
É possível programar o EC2Launch para ser executado em cada inicialização e não apenas na inicialização inicial.
Para programar o EC2Launch para ser executado em cada inicialização:
Abra o Windows PowerShell e execute o seguinte comando:
C:\ProgramData\Amazon\EC2-Windows\Launch\Scripts\InitializeInstance.ps1 -SchedulePerBoot
Ou execute o executável com o seguinte comando:
C:\ProgramData\Amazon\EC2-Windows\Launch\Settings\Ec2LaunchSettings.exe
Em seguida, selecione
Run EC2Launch on every boot
. É possível especificar que sua instância do EC2 sejaShutdown without Sysprep
ouShutdown with Sysprep
.
nota
Quando você habilita o EC2Launch para ser executado em cada inicialização, acontecerá o seguinte na próxima vez que o EC2Launch for executado:
-
Se o
AdminPasswordType
ainda estiver definido comoRandom
, o EC2Launch gerará uma nova senha na próxima inicialização. Após a reinicialização, oAdminPasswordType
é automaticamente definido comoDoNothing
para impedir que o EC2Launch gere novas senhas em inicializações subsequentes. Para evitar que o EC2Launch gere uma nova senha na primeira inicialização, defina manualmente oAdminPasswordType
comoDoNothing
antes de reiniciar. -
HandleUserData
será redefinido comofalse
a menos que os dados do usuário tenhampersist
definido comotrue
. Para ter mais informações, consulte Scripts de dados do usuário.
Inicializar unidades e mapear as letras de unidades
Especifique as configurações no arquivo DriveLetterMappingConfig.json
para mapear letras de unidades para volumes na instância do EC2. O script inicializa drives que ainda não foram inicializados e particionados. Para obter mais informações sobre como obter detalhes do volume no Windows, consulte Get-Volume
Para mapear letras de unidade a volumes
-
Abra o arquivo
C:\ProgramData\Amazon\EC2-Windows\Launch\Config\DriveLetterMappingConfig.json
em um editor de textos. -
Especifique as seguintes configurações de volume e salve suas alterações:
{ "driveLetterMapping": [ { "volumeName": "
sample volume
", "driveLetter": "H
" } ] } -
Abra o Windows PowerShell e use o seguinte comando para executar o script do EC2Launch que inicializa os discos:
C:\ProgramData\Amazon\EC2-Windows\Launch\Scripts\InitializeDisks.ps1
Para inicializar os discos sempre que a instância for inicializada, adicione o sinalizador
-Schedule
da seguinte forma:C:\ProgramData\Amazon\EC2-Windows\Launch\Scripts\InitializeDisks.ps1 -Schedule
Enviar logs de eventos do Windows ao console do EC2
Especifique configurações no arquivo EventLogConfig.json
para enviar logs de eventos do Windows aos logs do console do EC2.
Para definir as configurações para enviar logs de eventos do Windows
-
Na instância, abra o arquivo
C:\ProgramData\Amazon\EC2-Windows\Launch\Config\EventLogConfig.json
em um editor de texto. -
Configure as seguintes configurações de log e salve suas alterações:
{ "events": [ { "logName": "
System
", "source": "An event source (optional)
", "level": "Error | Warning | Information
", "numEntries":3
} ] } -
No Windows PowerShell, execute o seguinte comando para que o sistema agende o script para execução como uma tarefa agendada do Windows sempre que a instância for inicializada.
C:\ProgramData\Amazon\EC2-Windows\Launch\Scripts\SendEventLogs.ps1 -Schedule
Os logs podem demorar três minutos ou mais para aparecerem no console do EC2.
Enviar a mensagem O Windows está pronto após uma inicialização bem-sucedida
O serviço de EC2Config envia a mensagem “O Windows está pronto” ao console do EC2 após cada inicialização. O EC2Launch envia essa mensagem somente após a primeira inicialização. Para compatibilidade com versões anteriores do serviço de EC2Config, é possível agendar o EC2Launch para enviar essa mensagem após cada inicialização. Na instância, abra o Windows PowerShell e execute o seguinte comando. O sistema agenda o script para ser executado como uma tarefa agendada do Windows.
C:\ProgramData\Amazon\EC2-Windows\Launch\Scripts\SendWindowsIsReady.ps1 -Schedule