Opciones avanzadas y perfiles de ejecución de actualización de la Actualización compatible con clústeres

Se aplica a: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012, Azure Stack HCI, versiones 21H2 y 20H2

En este tema se describen las opciones de ejecución de actualización que pueden configurarse para una ejecución de actualización de la Actualización compatible con clústeres (CAU). Estas opciones avanzadas se pueden configurar cuando se usa la interfaz de usuario de CAU o los cmdlets de Windows PowerShell de CAU para aplicar actualizaciones o para configurar las opciones de autoactualización.

La mayoría de las opciones de configuración pueden guardarse como un archivo XML llamado perfil de ejecución de actualización, y reutilizarse más adelante para las ejecuciones de actualización. Los valores predeterminados de las opciones de ejecución de actualización proporcionados por CAU también se pueden usar en muchos entornos de clúster.

Para obtener más información acerca de las opciones adicionales que puede especificar para cada ejecución de actualización y de los perfiles de ejecución de actualización, consulte las siguientes secciones más adelante en este tema:

Opciones que se deben especificar al solicitar una ejecución de actualización Uso de perfiles de ejecución de actualización Opciones que se pueden establecer en un perfil de ejecución de actualización

En la siguiente tabla se enumeran las opciones que puede establecer en un perfil de ejecución de actualización de CAU.

Nota

Para establecer la opción PreUpdateScript o PostUpdateScript, asegúrese de que tanto Windows PowerShell como .NET Framework 4.6 o 4.5 estén instalados en su equipo y que la comunicación remota de PowerShell esté habilitada para cada nodo del clúster. Para obtener más información, consulte Configuración de los nodos para la administración remota en Requisitos y procedimientos recomendados para la Actualización compatible con clústeres.

Opción Valor predeterminado Detalles
StopAfter Tiempo ilimitado El tiempo, en minutos, transcurrido el cual la ejecución de actualización se detendrá si no se ha completado. Nota: Si especifica un script de PowerShell anterior o posterior a la actualización, el proceso entero de ejecución de scripts y realización de actualizaciones se deberá completar dentro del límite de tiempo especificado por StopAfter.
WarnAfter De forma predeterminada, no aparece ninguna advertencia. El tiempo en minutos transcurrido el cual aparecerá una advertencia si no se completó la ejecución de actualización (incluido un script previo y uno posterior a la actualización, si están configurados).
MaxRetriesPerNode 3 Número máximo de veces que se volverá a intentar realizar el proceso de actualización (incluido un script previo y uno posterior a la actualización, si están configurados) por nodo. El máximo es 64.
MaxFailedNodes En la mayoría de los clústeres, un número entero que corresponde a aproximadamente un tercio del número de nodos de clústeres. El número máximo de nodos en los que una actualización puede ser incorrecta, ya sea a causa de un error en los nodos o bien porque el servicio de clúster dejó de funcionar. Si se produce un error en uno o más nodos, se detiene la ejecución de actualización.

El intervalo válido de valores es de 0 a 1 menos que el número de nodos de clúster.

RequireAllNodesOnline None Especifica que todos los nodos deben estar en línea y ser accesibles antes de que comience la actualización.
RebootTimeoutMinutes 15 El tiempo, en minutos, que CAU permitirá para que se reinicie un nodo (en caso de que se requiera un reinicio) y para que comiencen los servicios de inicio automático. Si el proceso de reinicio no se completa en este tiempo, la ejecución de actualización en ese nodo se marcará como incorrecta.
PreUpdateScript None Ruta de acceso y nombre de archivo para que un script de PowerShell se ejecute en cada nodo antes de que comience la actualización y antes de que el nodo pase a modo de mantenimiento. La extensión de nombre de archivo debe ser .ps1 y, junto con el nombre de archivo, su longitud total no debe superar los 260 caracteres. El procedimiento recomendado es ubicar el script en un disco en el almacenamiento de clúster o en un recurso compartido de archivos en red de alta disponibilidad para asegurar que todos los nodos de clúster puedan acceder siempre a él. Si el script está ubicado en un recurso compartido de archivos en red, asegúrese de configurarlo de manera que el grupo Todos tenga permiso de lectura y de restringir el acceso de escritura para evitar que usuarios no autorizados alteren los archivos.

Si especifica un script previo a la actualización, asegúrese de que las opciones de configuración, como los límites de tiempo (por ejemplo, StopAfter), estén establecidas para permitir que el script se ejecute correctamente. Estos límites abarcan todo el proceso de ejecución de scripts e instalación de actualizaciones, no solo el proceso de instalación de actualizaciones.

PostUpdateScript None Ruta de acceso y nombre de archivo de un script de PowerShell que se va a ejecutar una vez que se complete la actualización (después de que el nodo salga del modo de mantenimiento). La extensión de nombre de archivo debe ser .ps1 y, junto con el nombre de archivo, su longitud total no debe superar los 260 caracteres. El procedimiento recomendado es ubicar el script en un disco en el almacenamiento de clúster o en un recurso compartido de archivos en red de alta disponibilidad para asegurar que todos los nodos de clúster puedan acceder siempre a él. Si el script está ubicado en un recurso compartido de archivos en red, asegúrese de configurarlo de manera que el grupo Todos tenga permiso de lectura y de restringir el acceso de escritura para evitar que usuarios no autorizados alteren los archivos.

Si especifica un script posterior a la actualización, asegúrese de que las opciones de configuración, como los límites de tiempo (por ejemplo, StopAfter), estén establecidas para permitir que el script se ejecute correctamente. Estos límites abarcan todo el proceso de ejecución de scripts e instalación de actualizaciones, no solo el proceso de instalación de actualizaciones.

ConfigurationName Esta configuración solo surte efecto si ejecuta scripts.

Si especifica un script anterior o posterior a la actualización, pero no especifica ConfigurationName, se emplea la configuración de sesión predeterminada para PowerShell (Microsoft.PowerShell).

Especifica la configuración de sesión de PowerShell que define la sesión en la que se ejecutan los scripts (especificados por PreUpdateScript and PostUpdateScript), y puede limitar los comandos que se pueden ejecutar.
CauPluginName Microsoft.WindowsUpdatePlugin Un complemento que se configura para que lo use la actualización compatible con clústeres para obtener una vista previa de las actualizaciones o realizar una ejecución de actualización. Para obtener más información, consulte Cómo funcionan los complementos de la Actualización compatible con clústeres.
CauPluginArguments None Un conjunto de pares nombre=valor (argumentos) para su uso por parte del complemento de actualización; por ejemplo:

Domain=Domain.local

Estos pares nombre=valor deben ser significativos para el complemento que especifique en CauPluginName.

Para especificar un argumento mediante la interfaz de usuario de CAU, escriba el nombre, presione la tecla Tabulador y escriba el valor que corresponda. Presione la tecla Tabulador nuevamente para proporcionar el siguiente argumento. Cada nombre y valor se separan automáticamente con un signo igual (=) . Si hay varios pares, se separan automáticamente con punto y coma.

El complemento predeterminado de Microsoft.WindowsUpdatePlugin no necesita argumentos. Sin embargo, se puede especificar un argumento opcional para, por ejemplo, especificar una cadena de consulta estándar del agente de Windows Update para filtrar las actualizaciones aplicadas por el complemento. Para un nombre, use QueryString; para un valor, adjunte la consulta completa entre comillas.

Para obtener más información, consulte Cómo funcionan los complementos de la Actualización compatible con clústeres.

Opciones que se deben especificar al solicitar una ejecución de actualización

En la siguiente tabla se enumeran las opciones (que no son las que se encuentran en el perfil de ejecución de actualización) que puede especificar al solicitar una ejecución de actualización. Para obtener información sobre las opciones que puede configurar en un perfil de ejecución de actualización, consulte la tabla anterior.

Opción Valor predeterminado Detalles
ClusterName Ninguno
Nota: Esta opción solo se puede establecer cuando la interfaz de usuario de CAU no se ejecuta en un nodo de clúster de conmutación por error, o cuando quiere hacer referencia a un clúster de conmutación por error diferente del clúster donde se ejecuta la interfaz de usuario de CAU.
Nombre NetBIOS del clúster en el que se lleva a cabo la ejecución de actualización.
Credential: Credenciales actuales de la cuenta Las credenciales administrativas para el clúster de destino en el que se llevará a cabo la ejecución de actualización. Quizás ya tenga las credenciales necesarias si inicia la interfaz de usuario de CAU desde una cuenta con derechos de administrador y permisos en el clúster (o si abre una sesión en PowerShell cuando emplea cmdlets de PowerShell de CAU).
NodeOrder De manera predeterminada, CAU comienza con el nodo que posee el menor número de roles en clúster y, a continuación, sigue con el nodo que tiene el segundo menor número y así sucesivamente. Los nombres de los nodos del clúster en el orden en que se deben actualizar (si es posible).

Usar perfiles de ejecución de actualización

Cada ejecución de actualización puede asociarse a un perfil de ejecución de actualización específico. El perfil de ejecución de actualización específico predeterminado se almacena en la carpeta %windir%\cluster. Si usa la interfaz de usuario de CAU en modo de actualización remota, puede especificar un perfil de ejecución de actualización en el momento en que aplique las actualizaciones, o bien puede usar el perfil de ejecución de actualización predeterminado. Si usa CAU en modo de autoactualización, puede importar la configuración de un perfil de ejecución de actualización específico cuando configure las opciones de autoactualización. En ambos casos, puede reemplazar los valores mostrados en las opciones de ejecución de actualización según sus necesidades. Si lo desea, puede guardar las opciones de ejecución de actualización como un perfil de ejecución de actualización con el mismo nombre de archivo o bien con un nombre diferente. La próxima vez que aplique las actualizaciones o configure las opciones de auto-actualización, CAU seleccionará de forma automática el perfil de ejecución de actualización seleccionado anteriormente.

Puede modificar un perfil de ejecución de actualización existente o crear uno nuevo mediante la opción Crear o modificar perfil de ejecución de actualización de la interfaz de usuario de CAU.

Estas son algunas notas importantes sobre el uso de perfiles de ejecución de actualización:

  • Los perfiles de ejecución de actualización no almacenan información específica de los clústeres, como las credenciales administrativas. Si usa CAU en modo de autoactualización, el perfil de ejecución de actualización tampoco almacena la información correspondiente a la programación de la autoactualización. Esto permite compartir un perfil de ejecución de actualización con todos los clústeres de conmutación por error en una clase específica.
  • Si configura las opciones de autoactualización mediante un perfil de ejecución de actualización y, después, modifica los valores de las opciones de ejecución de actualización de ese perfil, la configuración de la autoactualización no cambia automáticamente. Para aplicar la nueva configuración de ejecución de actualización, debe volver a configurar las opciones de auto-actualización.
  • Lamentablemente, el editor de perfil de ejecución no admite rutas de acceso de archivo que incluyan espacios, como C:\Archivos de programa. Como solución alternativa, almacene los scripts anteriores y posteriores a la actualización en una ruta de acceso que no incluya espacios, o bien use PowerShell exclusivamente para administrar los perfiles de ejecución y coloque comillas alrededor de la ruta de acceso al ejecutar Invoke-CauRun.

Comandos equivalentes de Windows PowerShell

Puede importar la configuración desde un perfil de ejecución de actualización al ejecutar el cmdlet Invoke-CauRun, Add-CauClusterRole o Set-CauClusterRole.

En el siguiente ejemplo se realiza un análisis y una ejecución de actualización completa en un clúster llamado CONTOSO-FC1, usando las opciones de ejecución de actualización especificadas en C:\Windows\Cluster\DefaultParameters.xml. Se usan los valores predeterminados para los parámetros de cmdlet restantes.

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

Mediante un perfil de ejecución de actualización, es posible actualizar un clúster de conmutación por error de forma repetible y con configuraciones coherentes en lo que respecta a administración de excepciones, límites de tiempo y otros parámetros operativos. Debido a que estas configuraciones normalmente son específicas de una clase de clústeres de conmutación por error (por ejemplo, "Todos los clústeres de Microsoft SQL Server" o "Clústeres críticos para la empresa"), recomendamos que asigne a cada perfil de ejecución de actualización un nombre en función de la clase de clústeres de conmutación por error con la que se usarán. Asimismo, recomendamos que administre el perfil de ejecución de actualización en un recurso compartido de archivos al que puedan acceder todos los clústeres de conmutación por error de una clase específica de su organización IT.

Referencias adicionales