As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # `AWSSupport-UpgradeWindowsAWSDrivers` **Descrição** O `AWSSupport-UpgradeWindowsAWSDrivers` runbook atualiza ou repara os AWS drivers de armazenamento e de rede na instância EC2 especificada. O runbook tenta instalar as versões mais recentes dos AWS drivers on-line chamando o SSM Agent. Se o SSM Agent não puder ser contatado, o runbook poderá realizar uma instalação offline dos AWS drivers, se solicitado explicitamente. Este runbook é compatível com os seguintes sistemas operacionais: + Windows Server 2016 + Windows Server 2019 + Windows Server 2022 + Windows Server 2025 **nota** Observação: tanto a atualização online e offline criará uma AMI antes de tentar quaisquer operações, que persistem após a conclusão da automação. É sua responsabilidade garantir acesso à AMI ou excluí-la. O método online reinicia a instância como parte do processo de atualização, enquanto o método offline requer que a instância do EC2 seja interrompida e depois iniciada. **Importante** Se suas instâncias se conectarem AWS Systems Manager usando VPC endpoints, esse runbook falhará, a menos que seja usado na região us-east-1. Este runbook também falhará em um controlador de domínio. Para atualizar os drivers AWS fotovoltaicos em um controlador de domínio, consulte [Atualizar um controlador de domínio (atualização AWS fotovoltaica](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/Upgrading_PV_drivers.html#aws-pv-upgrade-dc)). [Executar esta automação (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-UpgradeWindowsAWSDrivers) **Tipo de documento** Automação **Proprietário** Amazon **Plataformas** Windows **Parâmetros** + AllowOffline Tipo: string Valores válidos: True \$1 False Padrão: False Descrição: (Opcional) Defina como verdadeiro se você permitir uma atualização de drivers offline, caso a instalação online não possa ser realizada. Observação: O método offline requer que a instância do EC2 fornecida seja interrompida e, em seguida, iniciada. Dados armazenados em volumes de armazenamento de instâncias serão perdidos. O endereço IP público será alterado se você não estiver usando um IP elástico. + AutomationAssumeRole Tipo: string Descrição: (opcional) o nome do recurso da Amazon (ARN) do perfil do AWS Identity and Access Management (IAM) que permite que o Systems Manager Automation realize ações em seu nome. Se nenhum perfil for especificado, o Systems Manager Automation usa as permissões do usuário que inicia este runbook. + ForceUpgrade Tipo: string Valores válidos: True \$1 False Padrão: False Descrição: (opcional) apenas offline: defina como verdadeiro se você permitir que a atualização de drivers offline prossiga, mesmo que sua instância já tenha os drivers mais recentes instalados. + InstanceId Tipo: string Descrição: (obrigatória) o ID de sua instância do EC2 para o Windows Server. + SubnetId Tipo: string Padrão: SelectedInstanceSubnet Descrição: (Opcional) Somente off-line - O ID de sub-rede da instância do EC2 Rescue usado para realizar a atualização dos drivers off-line. Se nenhum ID de sub-rede for especificado, o Systems Manager Automation criará uma nova VPC. **Importante** A sub-rede deve estar na mesma InstanceId zona de disponibilidade e permitir o acesso aos endpoints do SSM. **Permissões obrigatórias do IAM** O parâmetro `AutomationAssumeRole` requer as seguintes ações para usar o runbook com êxito. A instância EC2 que recebe o comando deve ter, no mínimo, uma função do IAM que inclua permissões para **ssm: StartAutomationExecution** e **ssm: SendCommand** para executar a automação e enviar o comando para a instância, além de **ssm: GetAutomationExecution** para poder ler a saída da automação. Você pode anexar a política `AmazonSSMManagedInstanceCore` gerenciada pela Amazon à sua função do IAM para fornecer essas permissões. No entanto, recomendamos usar a função do IAM `AmazonSSMAutomationRole` de automação para essa finalidade. Para obter mais informações, consulte [Usar o IAM para configurar perfis para o Automation](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-permissions.html). Se você estiver executando uma atualização offline, consulte as permissões necessárias por [`AWSSupport-StartEC2RescueWorkflow`](automation-awssupport-startec2rescueworkflow.md). **Etapas do documento** 1. `aws:assertAwsResourceProperty`: verifica se a instância de entrada é Windows. 1. `aws:assertAwsResourceProperty`: verifica se a instância de entrada é uma instância gerenciada. Se esse for o caso, a atualização online é iniciada; caso contrário, a atualização offline é avaliada. 1. (Atualização online) Se a instância de entrada for uma instância gerenciada: 1. `aws:createImage`: cria um backup da AMI. 1. `aws:createTags`: marca o backup da AMI. 1. `aws:runCommand`- Instala o driver de rede ENA. 1. `aws:runCommand`- Instala o NVMe driver. 1. `aws:runCommand`- Instala o driver AWS fotovoltaico. 1. (Atualização offline) Se a instância de entrada não for uma instância gerenciada: 1. `aws:assertAwsResourceProperty`: verifica se o sinalizador AllowOffline está definido como `true`. Se esse for o caso, a atualização offline é iniciada; caso contrário, a automação termina. 1. `aws:changeInstanceState`: interrompe a parada da instância 1. `aws:changeInstanceState`: força a parada da instância de origem. 1. `aws:createImage`: cria uma AMI de backup da instância de origem. 1. `aws:createTags`: marca uma AMI de backup da instância de origem. 1. `aws:executeAwsApi`: ativa o ENA para a instância 1. `aws:assertAwsResourceProperty`- Afirme a ForceUpgrade bandeira. 1. (Forçar atualização offline) Se **ForceUpgrade = true**, execute `aws:executeAutomation` para invocar `AWSSupport-StartEC2RescueWorkflow` com o script de atualização forçada do driver. Isso instala os drivers independentemente da versão atual instalada 1. (Atualização offline) Se **ForceUpgrade = false**, execute `aws:executeAutomation` para invocar `AWSSupport-StartEC2RescueWorkflow` com o script de atualização de drivers. **Saídas** preUpgradeBackup.ImageId preOfflineUpgradeBackup. ImageId `installAwsEnaNetworkDriverOnInstance.Output` `installAWSNVMeOnInstance.Output` `installAWSPVDriverOnInstance.Output` upgradeDriversOffline.Saída forceUpgradeDriversOffline. Saída