Cluster-Aware la mise à jour des options avancées et des profils d’exécution de mise à jourCluster-Aware Updating advanced options and updating run profiles

S’applique à : Windows Server 2019, Windows Server 2016, Windows Server 2012 R2 et Windows Server 2012.Applies to: Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012.

Cette rubrique décrit les options d’exécution de mise à jour qui peuvent être configurées pour une exécution de mise à jour adaptée aux clusters .This topic describes Updating Run options that can be configured for a Cluster-Aware Updating (CAU) Updating Run. Vous pouvez configurer ces options avancées lorsque vous utilisez l’interface utilisateur de la mise à jour adaptée aux clusters ou les applets de commande Windows PowerShell de la mise à jour adaptée aux clusters pour appliquer des mises à jour ou configurer des options de mise à jour automatiqueThese advanced options can be configured when you use either the CAU UI or the CAU Windows PowerShell cmdlets to apply updates or to configure self-updating options.

La plupart des paramètres de configuration peuvent être enregistrés sous la forme d’un fichier XML appelé profil d’exécution de mise à jour et réutilisés pour des exécutions de mise à jour ultérieures.Most configuration settings can be saved as an XML file called an Updating Run Profile and reused for later Updating Runs. Les valeurs par défaut des options d’exécution de mise à jour qui sont fournies par la mise à jour adaptée aux clusters peuvent également être utilisées dans de nombreux environnements de clusters.The default values for the Updating Run options that are provided by CAU can also be used in many cluster environments.

Pour plus d’informations sur d’autres options que vous pouvez spécifier pour chaque exécution de mise à jour et sur les profils d’exécution de mise à jour, voir les sections suivantes plus loin dans cette rubrique :For information about additional options that you can specify for each Updating Run and about Updating Run Profiles, see the following sections later in this topic:

Les options que vous spécifiez lorsque vous demandez une exécution de mise à jour utilisent les options des profils d’exécution de mise à jour qui peuvent être définies dans un profil d’exécution de mise à jour.Options that you specify when you request an Updating Run Use Updating Run Profiles Options that can be set in an Updating Run Profile

Le tableau suivant répertorie les options que vous pouvez définir dans un profil d’exécution de mise à jour pour une mise à jour adaptée aux clusters.The following table lists options that you can set in a CAU Updating Run Profile.

Notes

Pour définir l’option PreUpdateScript ou PostUpdateScript, assurez-vous que Windows PowerShell et .NET Framework 4,6 ou 4,5 sont installés et que la communication à distance PowerShell est activée sur chaque nœud du cluster.To set the PreUpdateScript or PostUpdateScript option, ensure that Windows PowerShell and .NET Framework 4.6 or 4.5 are installed and that PowerShell remoting is enabled on each node in the cluster. Pour plus d’informations, consultez Configurer les nœuds pour la gestion à distance dans exigences et meilleures pratiques pour la mise à jour Cluster-Aware.For more information, see Configure the nodes for remote management in Requirements and Best Practices for Cluster-Aware Updating.

OptionOption Valeur par défautDefault value DétailsDetails
StopAfterStopAfter Durée illimitéeUnlimited time Délai, en minutes, au-delà duquel l’exécution de mise à jour sera arrêtée si elle n’est pas terminée.Time in minutes after which the Updating Run will be stopped if it has not completed. Remarque : Si vous spécifiez un script PowerShell antérieur à la mise à jour ou postérieur à la mise à jour, le processus complet d’exécution des scripts et d’exécution des mises à jour doit être terminé dans le délai imparti pour la StopAfter .Note: If you specify a pre-update or a post-update PowerShell script, the entire process of running scripts and performing updates must be complete within the StopAfter time limit.
WarnAfterWarnAfter Par défaut, aucun avertissement ne s’afficheBy default, no warning appears Délai, en minutes, au-delà duquel un avertissement est affiché si l’exécution de mise à jour (y compris un script antérieur à la mise à jour et un script postérieur à la mise à jour, s’ils sont configurés) n’est pas terminée.Time in minutes after which a warning will appear if the Updating Run (including a pre-update script and a post-update script, if they are configured) has not completed.
MaxRetriesPerNodeMaxRetriesPerNode 33 Nombre maximal de fois où le processus de mise à jour (y compris un script antérieur à la mise à jour et un script postérieur à la mise à jour, s’ils sont configurés) sera relancé par nœud.Maximum number of times that the update process (including a pre-update script and a post-update script, if they are configured) will be retried per node. La valeur maximale est 64.The maximum is 64.
MaxFailedNodesMaxFailedNodes Pour la plupart des clusters, un entier à peu près égal au tiers du nombre de nœuds de clusterFor most clusters, an integer that is approximately one-third of the number of cluster nodes Nombre maximal de nœuds sur lesquels la mise à jour peut échouer, en raison de l’échec des nœuds ou de l’arrêt de l’exécution du service de cluster.Maximum number of nodes on which updating can fail, either because the nodes fail or the Cluster service stops running. Si un nœud supplémentaire échoue, l’exécution de mise à jour est arrêtée.If one more node fails, the Updating Run is stopped.

La plage valide contient des valeurs inférieures de 0 à 1 au nombre de nœuds de cluster.The valid range of values is 0 to 1 less than the number of cluster nodes.

RequireAllNodesOnlineRequireAllNodesOnline AucunNone Indique que tous les nœuds doivent être en ligne et accessibles avant le début de la mise à jour.Specifies that all nodes must be online and reachable before updating begins.
RebootTimeoutMinutesRebootTimeoutMinutes 1515 Délai, en minutes, que la mise à jour adaptée aux clusters autorisera pour le redémarrage d’un nœud (si un redémarrage est nécessaire) et le démarrage de tous les services de démarrage automatique.Time in minutes that CAU will allow for restarting a node (if a restart is necessary) and starting all auto-start services. Si le processus de redémarrage ne se termine pas dans ce délai, l’exécution de mise à jour sur ce nœud est marquée comme ayant échoué.If the restart process doesn't complete within this time, the Updating Run on that node is marked as failed.
PreUpdateScriptPreUpdateScript AucunNone Le chemin d’accès et le nom de fichier d’un script PowerShell à exécuter sur chaque nœud avant le début de la mise à jour, et avant que le nœud soit mis en mode maintenance.The path and file name for a PowerShell script to run on each node before updating begins, and before the node is put into maintenance mode. L’extension de nom de fichier doit être . ps1, et la longueur totale du chemin d’accès et du nom de fichier ne doit pas dépasser 260 caractères.The file name extension must be .ps1, and the total length of the path plus file name must not exceed 260 characters. Nous vous recommandons, à titre de meilleure pratique, de placer le script sur un disque dans le stockage du cluster ou sur un partage de fichiers réseau hautement disponible pour garantir qu’il est toujours accessible à tous les nœuds de cluster.As a best practice, the script should be located on a disk in cluster storage, or at a highly available network file share, to ensure that it is always accessible to all of the cluster nodes. Si le script est situé sur un partage de fichiers réseau, assurez-vous de configurer le partage avec l’autorisation de lecture pour le groupe Tout le monde et limitez l’accès en écriture pour empêcher toute falsification des fichiers par des utilisateurs non autorisés.If the script is located on a network file share, ensure that you configure the file share for Read permission for the Everyone group, and restrict write access to prevent tampering with the files by unauthorized users.

Si vous spécifiez un script antérieur à la mise à jour, assurez-vous que des paramètres tels que les limites de temps (par exemple, StopAfter) sont configurés pour permettre l’exécution correcte du script.If you specify a pre-update script, be sure that settings such as the time limits (for example, StopAfter) are configured to allow the script to run successfully. Ces limites couvrent la totalité du processus d’exécution des scripts et d’installation des mises à jour, et pas seulement le processus d’installation des mises à jour.These limits span the entire process of running scripts and installing updates, not just the process of installing updates.

PostUpdateScriptPostUpdateScript AucunNone Chemin d’accès et nom de fichier d’un script PowerShell à exécuter une fois la mise à jour terminée (après que le nœud a quitté le mode de maintenance).The path and file name for a PowerShell script to run after updating completes (after the node leaves maintenance mode). L’extension de nom de fichier doit être . ps1 et la longueur totale du chemin d’accès plus le nom de fichier ne doit pas dépasser 260 caractères.The file name extension must be .ps1 and the total length of the path plus file name must not exceed 260 characters. Nous vous recommandons, à titre de meilleure pratique, de placer le script sur un disque dans le stockage du cluster ou sur un partage de fichiers réseau hautement disponible pour garantir qu’il est toujours accessible à tous les nœuds de cluster.As a best practice, the script should be located on a disk in cluster storage, or at a highly available network file share, to ensure that it is always accessible to all of the cluster nodes. Si le script est situé sur un partage de fichiers réseau, assurez-vous de configurer le partage avec l’autorisation de lecture pour le groupe Tout le monde et limitez l’accès en écriture pour empêcher toute falsification des fichiers par des utilisateurs non autorisés.If the script is located on a network file share, ensure that you configure the file share for Read permission for the Everyone group, and restrict write access to prevent tampering with the files by unauthorized users.

Si vous spécifiez un script postérieur à la mise à jour, assurez-vous que des paramètres tels que les limites de temps (par exemple, StopAfter) sont configurés pour permettre l’exécution correcte du script.If you specify a post-update script, be sure that settings such as the time limits (for example, StopAfter) are configured to allow the script to run successfully. Ces limites couvrent la totalité du processus d’exécution des scripts et d’installation des mises à jour, et pas seulement le processus d’installation des mises à jour.These limits span the entire process of running scripts and installing updates, not just the process of installing updates.

ConfigurationNameConfigurationName Ce paramètre n’a d’effet que si vous exécutez des scripts.This setting only has an effect if you run scripts.

Si vous spécifiez un script antérieur à la mise à jour ou un script postérieur à la mise à jour, mais que vous ne spécifiez pas de ConfigurationName, la configuration de session par défaut pour PowerShell (Microsoft. PowerShell) est utilisée.If you specify a pre-update script or a post-update script, but you do not specify a ConfigurationName, the default session configuration for PowerShell (Microsoft.PowerShell) is used.

Spécifie la configuration de session PowerShell qui définit la session dans laquelle les scripts (spécifiés par PreUpdateScript et PostUpdateScript) sont exécutés, et peut limiter les commandes qui peuvent être exécutées.Specifies the PowerShell session configuration that defines the session in which scripts (specified by PreUpdateScript and PostUpdateScript) are run, and can limit the commands that can be run.
CauPluginNameCauPluginName Microsoft.WindowsUpdatePluginMicrosoft.WindowsUpdatePlugin Plug-in que vous configurez avec la Mise à jour adaptée aux clusters à utiliser pour afficher un aperçu des mises à jour ou effectuer une exécution de mise à jour.Plug-in that you configure Cluster-Aware Updating to use to preview updates or perform an Updating Run. Pour plus d’informations, consultez la rubrique fonctionnement de la Cluster-Aware de la mise à jour des plug-ins.For more information, see How Cluster-Aware Updating plug-ins work.
CauPluginArgumentsCauPluginArguments AucunNone Ensemble de paires de type nom=valeur (arguments) pour le plug-in de mise à jour à utiliser ; par exemple :A set of name=value pairs (arguments) for the updating plug-in to use, for example:

Domaine = domaine. localDomain=Domain.local

Ces paires nom=valeur doivent être significatives pour le plug-in que vous spécifiez dans CauPluginName.These name=value pairs must be meaningful to the plug-in that you specify in CauPluginName.

Pour spécifier un argument à l’aide de l’interface utilisateur de la mise à jour adaptée aux clusters, tapez le nom, appuyez sur la touche Tab, puis tapez la valeur correspondante.To specify an argument using the CAU UI, type the name, press the Tab key, and then type the corresponding value. Appuyez à nouveau sur la touche Tab pour fournir l’argument suivant.Press the Tab key again to provide the next argument. Chaque nom et chaque valeur sont automatiquement séparés par un signe égal (=).Each name and value are automatically separated with an equal (=) sign. Plusieurs paires sont automatiquement séparées par des points-virgules.Multiple pairs are automatically separated with semicolons.

Pour le plug-in Microsoft. WindowsUpdatePlugin par défaut, aucun argument n’est nécessaire.For the default Microsoft.WindowsUpdatePlugin plug-in, no arguments are needed. Toutefois, vous pouvez spécifier un argument facultatif, par exemple pour spécifier une chaîne de requête standard émise par l’Agent de mise à jour automatique Windows Update pour filtrer l’ensemble des mises à jour appliquées par le plug-in.However, you can specify an optional argument, for example to specify a standard Windows Update Agent query string to filter the set of updates that are applied by the plug-in. Pour un nom, utilisez QueryString et, pour une valeur, mettez la requête complète entre guillemets.For a name, use QueryString, and for a value, enclose the full query in quotation marks.

Pour plus d’informations, consultez la rubrique fonctionnement de la Cluster-Aware de la mise à jour des plug-ins.For more information, see How Cluster-Aware Updating plug-ins work.

Options que vous spécifiez lorsque vous demandez une exécution de mise à jourOptions that you specify when you request an Updating Run

Le tableau suivant répertorie les options (autres que celles présentes dans un profil d’exécution de mise à jour) que vous pouvez spécifier lorsque vous demandez une exécution de mise à jour.The following table lists options (other than those in an Updating Run Profile) that you can specify when you request an Updating Run. Pour plus d’informations sur les options que vous pouvez définir dans un profil d’exécution de mise à jour, voir le tableau précédent.For information about options that you can set in an Updating Run Profile, see the preceding table.

OptionOption Valeur par défautDefault value DétailsDetails
ClusterNameClusterName AucunNone
Remarque : Cette option ne doit être définie que lorsque l’interface utilisateur de la mise à jour adaptée aux clusters n’est pas exécutée sur un nœud de cluster de basculement ou si vous souhaitez référencer un cluster de basculement différent de celui où l’interface utilisateur de la mise à jourNote: This option must be set only when the CAU UI is not run on a failover cluster node, or you want to reference a failover cluster different from where the CAU UI is run.
Nom NetBIOS du cluster sur lequel effectuer l’exécution de mise à jour.NetBIOS name of the cluster on which to perform the Updating Run.
Informations d'identificationCredential Informations d’identification de compte en coursCurrent account credentials Informations d’identification administratives du cluster cible sur lequel l’exécution de mise à jour sera effectuée.Administrative credentials for the target cluster on which the Updating Run will be performed. Vous disposez peut-être déjà des informations d’identification nécessaires si vous démarrez l’interface utilisateur de la mise à jour adaptée aux clusters (ou ouvrez une session PowerShell, si vous utilisez les applets de commande PowerShell de la mise à jour adaptée aux clusters) à partir d’un compte disposant des droits d’administrateur et des autorisationsYou may already have the necessary credentials if you start the CAU UI (or open a PowerShell session, if you're using the CAU PowerShell cmdlets) from an account that has administrator rights and permissions on the cluster.
NodeOrderNodeOrder Par défaut, la mise à jour adaptée aux clusters démarre avec le nœud possédant le plus petit nombre de rôles en cluster, puis progresse vers le nœud ayant le deuxième plus petit nombre de rôles, etc.By default, CAU starts with the node that owns the smallest number of clustered roles, then progresses to the node that has the second smallest number, and so on. Noms des nœuds de cluster dans l’ordre où ils devraient être mis à jour (si possible).Names of the cluster nodes in the order that they should be updated (if possible).

Utiliser des profils d’exécution de mise à jourUse Updating Run Profiles

Chaque exécution de mise à jour peut être associée à un profil d’exécution de mise à jour spécifique.Each Updating Run can be associated with a specific Updating Run Profile. Le profil d’exécution de mise à jour par défaut est stocké dans le dossier %windir%\Cluster .The default Updating Run Profile is stored in the %windir%\cluster folder. Si vous utilisez l’interface utilisateur de la mise à jour adaptée aux clusters en mode de mise à jour à distance, vous pouvez spécifier un profil d’exécution de mise à jour au moment où vous appliquez les mises à jour, ou vous pouvez utiliser le profil d’exécution de mise à jour par défaut.If you're using the CAU UI in remote-updating mode, you can specify an Updating Run Profile at the time that you apply updates, or you can use the default Updating Run profile. Si vous utilisez la mise à jour adaptée aux clusters en mode de mise à jour automatique, vous pouvez importer les paramètres à partir d’un profil d’exécution de mise à jour spécifié lorsque vous configurez les options de mise à jour automatique.If you're using CAU in self-updating mode, you can import the settings from a specified Updating Run Profile when you configure the self-updating options. Dans les deux cas, vous pouvez remplacer les valeurs affichées pour les options d’exécution de mise à jour en fonction de vos besoins.In both cases, you can override the displayed values for the Updating Run options according to your needs. Si vous le souhaitez, vous pouvez enregistrer les options d’exécution de mise à jour en tant que profil d’exécution de mise à jour sous le même nom de fichier ou sous un autre nom de fichier.If you want, you can save the Updating Run options as an Updating Run Profile with the same file name or a different file name. La prochaine fois que vous appliquez des mises à jour ou configurez les options de mise à jour automatique, la mise à jour adaptée aux clusters sélectionne automatiquement le profil d’exécution de mise à jour précédemment sélectionné.The next time that you apply updates or configure self-updating options, CAU automatically selects the Updating Run Profile that was previously selected.

Vous pouvez modifier un profil d’exécution de mise à jour existant ou en créer un en sélectionnant créer ou modifier un profil d’exécution de mise à jour dans l’interface utilisateur de la mise à jour adaptée aux clusters.You can modify an existing Updating Run Profile or create a new one by selecting Create or modify Updating Run Profile in the CAU UI.

Voici quelques remarques importantes concernant l’utilisation des profils d’exécution de mise à jour :Here are some important notes about using Updating Run Profiles:

  • Un profil d’exécution de mise à jour ne stocke pas d’informations spécifiques au cluster, telles que les informations d’identification d’administration.An Updating Run Profile doesn't store cluster-specific information such as administrative credentials. Si vous utilisez la mise à jour adaptée aux clusters en mode de mise à jour automatique, le profil d’exécution de mise à jour ne stocke pas non plus les informations de planification de mise à jour automatique.If you're using CAU in self-updating mode, the Updating Run Profile also doesn't store the self-updating schedule information. Il est ainsi possible de partager un profil d’exécution de mise à jour entre tous les clusters de basculement d’une classe spécifiée.This makes it possible to share an Updating Run Profile across all failover clusters in a specified class.
  • Si vous configurez les options de mise à jour automatique à l’aide d’un profil d’exécution de mise à jour et que vous modifiez ultérieurement le profil avec des valeurs différentes pour les options d’exécution de mise à jour, la configuration de mise à jour automatique ne change pas automatiquement.If you configure self-updating options using an Updating Run Profile and later modify the profile with different values for the Updating Run options, the self-updating configuration doesn't change automatically. Pour appliquer les nouveaux paramètres d’exécution de mise à jour, vous devez à nouveau configurer les options de mise à jour automatique.To apply the new Updating Run settings, you must configure the self-updating options again.
  • L’éditeur de profil d’exécution ne prend malheureusement pas en charge les chemins d’accès aux fichiers qui incluent des espaces, comme C:\Program Files.The Run Profile Editor unfortunately doesn't support file paths that include spaces, such as C:\Program Files. Pour résoudre ce problème, stockez vos scripts antérieurs et postérieurs à la mise à jour dans un chemin d’accès qui n’inclut pas d’espaces, ou utilisez exclusivement PowerShell pour gérer les profils d’exécution, en plaçant des guillemets autour du chemin d’accès lors de l’exécution de Invoke-CauRun.As a workaround, store your pre and post update scripts in a path that doesn't include spaces, or use PowerShell exclusively to manage Run Profiles, putting quotes around the path when running Invoke-CauRun.

Commandes Windows PowerShell équivalentesWindows PowerShell equivalent commands

Vous pouvez importer les paramètres à partir d’un profil d’exécution de mise à jour lorsque vous exécutez l’applet de commande Invoke-CauRun, Add-CauClusterRole ou Set-CauClusterRole .You can import the settings from an Updating Run Profile when you run the Invoke-CauRun, Add-CauClusterRole, or Set-CauClusterRole cmdlet.

L’exemple suivant effectue une analyse et une exécution de mise à jour entière sur le cluster nommé CONTOSO-FC1 en utilisant les options d’exécution de mise à jour qui sont spécifiées dans C:\Windows\Cluster\DefaultParameters.xml.The following example performs a scan and a full Updating Run on the cluster named CONTOSO-FC1, using the Updating Run options that are specified in C:\Windows\Cluster\DefaultParameters.xml. Les valeurs par défaut sont utilisées pour les paramètres d’applet de commande restants.Default values are used for the remaining cmdlet parameters.

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

À l’aide d’un profil d’exécution de mise à jour, vous pouvez mettre à jour un cluster de basculement de façon répétée avec des paramètres cohérents pour la gestion des exceptions, des durées déterminées et d’autres paramètres de fonctionnement.By using an Updating Run Profile, you can update a failover cluster in a repeatable fashion with consistent settings for exception management, time bounds, and other operational parameters. Étant donné que ces paramètres sont généralement spécifiques à une classe de clusters de basculement, tels que « tous les clusters Microsoft SQL Server », ou « mes clusters critiques », vous pouvez nommer chaque profil d’exécution de mise à jour en fonction de la classe des clusters de basculement avec laquelle il sera utilisé.Because these settings are typically specific to a class of failover clusters—such as "All Microsoft SQL Server clusters", or "My business-critical clusters"—you might want to name each Updating Run Profile according to the class of Failover Clusters it will be used with. En outre, vous pouvez gérer le profil d’exécution de mise à jour sur un partage de fichiers qui est accessible à tous les clusters de basculement d’une classe spécifique dans votre département informatique.In addition, you might want to manage the Updating Run Profile on a file share that is accessible to all of the failover clusters of a specific class in your IT organization.

Références supplémentairesAdditional References