Opções avançadas e perfis de execução de atualização da Atualização com Suporte a Cluster

Aplica-se a: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012, Azure Stack HCI, versões 21H2 e 20H2

Este tópico descreve as opções de Execução de Atualização que podem ser configuradas para uma Execução de Atualização da CAU (Atualização com Suporte a Cluster). Essas opções avançadas podem ser configuradas quando você usa a interface do usuário da CAU ou os cmdlets do Windows PowerShell da CAU para aplicar atualizações ou configurar opções de autoatualização.

É possível salvar a maioria das definições de configuração como um arquivo XML denominado Perfil de Execução de Atualização, que pode ser reutilizado para Execuções de Atualização posteriores. Os valores padrão das opções de Execução de Atualização, que são fornecidos pela CAU, também podem ser reutilizados em muitos ambientes de cluster.

Para obter informações sobre opções adicionais que você pode especificar para cada Execução de Atualização e sobre Perfis de Execução de Atualização, consulte as seguintes seções, posteriormente neste tópico:

As opções que você especifica quando solicita uma Execução de Atualização usam opções de Perfis de Execução de Atualização que podem ser definidas em um Perfil de Execução de Atualização

A tabela a seguir lista as opções que podem ser definidas em uma Execução de Atualização da CAU.

Observação

Para definir a opção PreUpdateScript ou PostUpdateScript, verifique se o Windows PowerShell e o .NET Framework 4.6 ou 4.5 estão instalados e se a comunicação remota do PowerShell está habilitada em cada nó do cluster. Para saber mais, confira Configurar os nós para gerenciamento remoto em Requisitos e práticas recomendadas para Atualização com Suporte a Cluster.

Opção Valor padrão Detalhes
StopAfter Tempo ilimitado O tempo em minutos após o qual a Execução de Atualização será interrompida se não tiver sido concluída. Observação: se você especificar um script do PowerShell de pré- ou pós-atualização, todo o processo de execução de scripts e atualizações precisará ser concluído no limite de tempo de StopAfter.
WarnAfter Por padrão, nenhum aviso é exibido Tempo em minutos após o qual um aviso será exibido se a Execução de Atualização (incluindo um script de pré-atualização e de pós-atualização, se estiverem configurados) não tiver sido concluída.
MaxRetriesPerNode 3 Número máximo de vezes que o processo de atualização (incluindo um script de pré-atualização e de pós-atualização, se estiverem configurados) será repetido por nó. O máximo é 64.
MaxFailedNodes Para a maioria dos clusters, um número inteiro que corresponde a aproximadamente um terço do número de nós do cluster O número máximo de nós em que a atualização pode falhar devido a falhas nos nós ou interrupção do Serviço de cluster. Se um ou mais nós falharem, a Execução de Atualização será interrompida.

O intervalo válido de valores é de 0 a 1, menor do que número de nós do cluster.

RequireAllNodesOnline Nenhum Especifica se todos os nós devem estar online e acessíveis antes de começar a atualização.
RebootTimeoutMinutes 15 Tempo em minutos durante o qual a CAU permitirá a reinicialização de um nó (caso seja necessária uma reinicialização) e a inicialização de todos os serviços de início automático. Se a reinicialização não for concluída nesse período, a Execução de Atualização nesse nó receberá a marcação 'com falha'.
PreUpdateScript Nenhum O caminho e o nome do arquivo de um script do PowerShell a ser executado em cada nó antes do início da atualização e antes que o nó seja colocado no modo de manutenção. A extensão de nome de arquivo precisa ser .ps1 e o comprimento total do caminho mais o nome do arquivo não podem ultrapassar 260 caracteres. Como prática recomendada, o script deve estar localizado em um disco, no armazenamento de cluster, ou em um compartilhamento de arquivos de rede com alta disponibilidade, para garantir que estará sempre acessível em todos os nós do cluster. Se o script estiver localizado em um compartilhamento de arquivos de rede, configure o compartilhamento de arquivos com a permissão de leitura para o grupo Todos e restrinja o acesso para gravação para impedir que usuários não autorizados falsifiquem os arquivos.

Se você especificar um script de pré-atualização, verifique se algumas configurações, como limites de tempo (por exemplo, StopAfter), estão configuradas para que o script seja executado com êxito. Esses limites abrangem todo o processo de execução de scripts e instalação de atualizações, não apenas o processo de instalação de atualizações.

PostUpdateScript Nenhum O caminho e o nome do arquivo de um script do PowerShell a ser executado após a conclusão da atualização (após o nó sair do modo de manutenção). A extensão de nome de arquivo precisa ser .ps1 e o comprimento total do caminho mais o nome do arquivo não podem ultrapassar 260 caracteres. Como prática recomendada, o script deve estar localizado em um disco, no armazenamento de cluster, ou em um compartilhamento de arquivos de rede com alta disponibilidade, para garantir que estará sempre acessível em todos os nós do cluster. Se o script estiver localizado em um compartilhamento de arquivos de rede, configure o compartilhamento de arquivos com a permissão de leitura para o grupo Todos e restrinja o acesso para gravação para impedir que usuários não autorizados falsifiquem os arquivos.

Se você especificar um script de pós-atualização, verifique se algumas configurações, como limites de tempo (por exemplo, StopAfter), estão configuradas para que o script seja executado com êxito. Esses limites abrangem todo o processo de execução de scripts e instalação de atualizações, não apenas o processo de instalação de atualizações.

ConfigurationName Essa configuração só terá efeito se você executar scripts.

Se você especificar um script de pré- ou pós-atualização, mas não definir um ConfigurationName, a configuração de sessão padrão do PowerShell (Microsoft.PowerShell) será usada.

Especifica a configuração de sessão do PowerShell que define a sessão em que os scripts (especificados por PreUpdateScript e PostUpdateScript) são executados e pode limitar os comandos que podem ser executados.
CauPluginName Microsoft.WindowsUpdatePlugin Plug-in no qual você configura a Atualização com Suporte a Cluster a ser usada para visualizar atualizações ou executar uma Execução de Atualização. Para saber mais, confira Como os plug-ins da Atualização com Suporte a Cluster funcionam.
CauPluginArguments Nenhum Um conjunto de pares (argumentos) nome=valor do plug-in para atualização a ser usado, por exemplo:

Domain=Domain.local

Esses pares nome=valor devem ser significativos para o plug-in especificado em CauPluginName.

Para especificar um argumento usando a interface do usuário da CAU, digite o name (nome), pressione a tecla Tab e digite o value (valor) correspondente. Pressione a tecla TAB novamente para fornecer o próximo argumento. Cada nome e valor é automaticamente separado por um sinal de igual (=). Vários pares são separados automaticamente por ponto e vírgula.

Para o plug-in Microsoft.WindowsUpdatePlugin padrão, nenhum argumento é necessário. Entretanto, é possível especificar um argumento opcional; por exemplo, para definir um consulta padrão do Windows Update Agent para filtrar o conjunto de atualizações a ser aplicado pelo plug-in. Para nome, use QueryString e para valor, coloque a consulta inteira entre aspas.

Para saber mais, confira Como os plug-ins da Atualização com Suporte a Cluster funcionam.

Opções que você pode especificar ao solicitar uma Execução de Atualização

A tabela a seguir lista opções (que não aquelas em um Perfil de Execução de Atualização) que você pode especificar ao solicitar uma Execução de Atualização. Para obter informações sobre as opções que podem ser definidas em um Perfil de Execução de Atualização, consulte a tabela anterior.

Opção Valor padrão Detalhes
ClusterName Nenhuma
Observação: esta opção só deve ser configurada quando a interface do usuário da CAU não é executada em um nó de cluster de failover ou quando você quer referenciar um cluster de failover diferente daquele em que a interface do usuário da CAU é executado.
Nome do NetBIOS no qual a Execução de Atualização será realizada.
Credencial Credenciais atuais da conta Credenciais administrativas do cluster de destino no qual realizar a Execução de Atualização. Talvez você já tenha as credenciais necessárias se tiver iniciado a interface do usuário da CAU (ou aberto uma sessão do PowerShell se estiver usando cmdlets do PowerShell da CAU) de uma conta que tem direitos e permissões de administrador no cluster.
NodeOrder Por padrão, a CAU é iniciada com o nó que contém o menor número de funções clusterizadas; depois, avança para o nó com o segundo menor número de funções e assim por diante. Nomes dos nós do cluster na ordem em que precisam ser atualizados (se possível).

Usar Perfis de Execução de Atualização

Cada Execução de Atualização pode ser associada a um Perfil de Execução de Atualização específico. O Perfil de Execução de Atualização padrão está armazenado na pasta %windir%\cluster. Se estiver usando a interface do usuário da CAU no modo de atualização remota, você poderá especificar um Perfil de Execução de Atualização no momento de aplicar as atualizações ou poderá usar o Perfil de Execução de Atualização padrão. Se estiver usando a CAU no modo de autoatualização, você poderá importar as configurações de um Perfil de Execução de Atualização especificado quando configurar as opções de autoatualização. Nos dois casos, é possível substituir os valores exibidos para as opções de Execução de Atualização, de acordo com as suas necessidades. Se quiser, você poderá salvar as opções de Execução de Atualização como um Perfil de Execução de Atualização, usando o mesmo nome de arquivo ou um diferente. Na próxima vez que aplicar atualizações ou configurar opções de autoatualização, a CAU selecionará automaticamente o Perfil de Execução de Atualização escolhido antes.

Você pode modificar um Perfil de Execução de Atualização existente ou pode criar um selecionando Criar ou modificar Perfil de Execução de Atualização na interface do usuário da CAU.

Estas são algumas observações importantes sobre o uso de Perfis de Execução de Atualização:

  • Um Perfil de Execução de Atualização não armazena informações específicas do cluster, como as credenciais administrativas. Se você estiver usando a CAU no modo de autoatualização, o Perfil de Execução de Atualização também não armazenará as informações do agendamento de autoatualização. Isso torna possível o compartilhamento de um Perfil de Execução de Atualização em todos os clusters de failover de uma classe específica.
  • Se você configurar opções de autoatualização usando um Perfil de Execução de Atualização e, mais tarde, modificar o perfil com valores diferentes para as opções de Execução de Atualização, a configuração de autoatualização não será alterada automaticamente. Para aplicar as novas configurações da Execução de Atualização, configure novamente as opções de autoatualização.
  • Infelizmente, o Editor de Perfil de Execução não dá suporte a caminhos de arquivo que incluem espaços, como C:\Arquivos de Programas. Como solução alternativa, armazene os scripts de pré- e pós-atualização em um caminho que não inclua espaços ou use o PowerShell exclusivamente para gerenciar Perfis de Execução, colocando aspas ao redor do caminho ao executar Invoke-CauRun.

Comandos equivalentes do Windows PowerShell

Você pode importar as configurações de um Perfil de Execução de Atualização ao executar o cmdlet Invoke-CauRun, Add-CauClusterRole ou Set-CauClusterRole.

O exemplo a seguir realiza uma verificação e uma Execução de Atualização completa no cluster denominado CONTOSO-FC1 usando as opções de Execução de Atualização especificadas em C:\Windows\Cluster\DefaultParameters.xml. Os valores padrão são usados para o restante dos parâmetros de cmdlet.

$MyRunProfile = Import-Clixml C:\Windows\Cluster\DefaultParameters.xml
Invoke-CauRun –ClusterName CONTOSO-FC1 @MyRunProfile

Usando um Perfil de Execução de Atualização, você pode atualizar repetidamente um cluster de failover, com definições consistentes ao gerenciamento de exceções, tempo associado e outros parâmetros operacionais. Como essas configurações são tipicamente específicas de uma classe de clusters de failover – como "Todos os clusters do Microsoft SQL Server" ou "Meus clusters essenciais aos negócios" –, pode ser conveniente nomear cada Perfil de Execução de Atualização de acordo com a classe de Clusters de Failover com a qual serão usados. Também pode ser conveniente gerenciar o Perfil de Execução de Atualização em um compartilhamento de arquivos que seja acessível a todos os clusters de failover de uma determinada classe, na sua organização de TI.

Referências adicionais