Обновление расширенных параметров и обновление профилей выполнения с учетом кластеров

Область применения: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012, Azure Stack HCI, версии 21H2 и 20H2

В этом разделе описаны параметры обновления запуска, которые можно настроить для запуска обновления, поддерживающего кластерное обновление (CAU). Эти дополнительные параметры можно настроить при использовании пользовательского интерфейса CAU или командлетов CAU Windows PowerShell для применения обновлений или настройки параметров самостоятельного обновления.

Большинство параметров конфигурации можно сохранить в XML-файле, который называется профилем прогона обновления, и использовать для следующих прогонов. Значения по умолчанию, заданные CAU для параметров прогона обновления, также можно использовать во множестве кластерных сред.

Сведения о дополнительных параметрах, которые можно задавать для каждого прогона обновления, и о профилях прогона обновления см. далее в следующих разделах.

Параметры, которые задаются при запросе параметра "Обновить запуск" с помощью параметров обновления профилей запуска, которые можно задать в профиле запуска обновления

В следующей таблице перечислены параметры, которые можно настроить в профиле прогона обновления CAU.

Примечание.

Чтобы задать параметр PreUpdateScript или PostUpdateScript, убедитесь, что windows PowerShell и платформа .NET Framework 4.6 или 4.5 установлены, а на каждом узле в кластере включено удаленное взаимодействие PowerShell. Дополнительные сведения см. в разделе "Настройка узлов для удаленного управления в требованиях и рекомендациях по обновлению с учетом кластеров".

Вариант Default value Сведения
StopAfter Неограниченное время Время (в минутах), по истечении которого незавершенное выполнение обновления будет остановлено. Примечание. При указании предварительного обновления или скрипта PowerShell после обновления весь процесс выполнения скриптов и выполнение обновлений должно быть завершено в течение периода времени StopAfter .
WarnAfter По умолчанию предупреждение не выводится Время (в минутах), по истечении которого появится предупреждение, если выполнение обновления (включая сценарии pre-update и post-update, если они настроены) не было завершено.
MaxRetriesPerNode 3 Максимальное число попыток обновлений на один узел (включая сценарии pre-update и post-update, если они настроены). Максимальное значение равно 64.
MaxFailedNodes Для большинства кластеров — целое число, примерно равное трети от количества узлов кластера Максимальное количество узлов, на которых обновление может завершиться ошибкой из-за отказа узла или остановки службы кластеров. Если данное число превышено, выполнение обновления прекращается.

Диапазон допустимых значений: от 0 до числа узлов кластеров, уменьшенного на 1.

RequireAllNodesOnline нет Указывает, что все узлы должны находиться в сети и быть достижимыми перед началом обновления.
RebootTimeoutMinutes 15 Время (в минутах), отводимое CAU на перезагрузку узла (если она необходима) и запуск всех служб автоматического запуска. Если процесс перезапуска не завершен в течение этого времени, обновление запуска на этом узле помечается как сбой.
PreUpdateScript нет Путь и имя файла для скрипта PowerShell, выполняемого на каждом узле перед началом обновления, и перед тем, как узел будет помещен в режим обслуживания. Расширение имени файла должно быть PS1, а общая длина пути плюс имени файла не должна превышать 260 символов. Чтобы сценарий был всегда доступен для всех узлов кластера, рекомендуется размещать его на диске в системе хранения данных кластера или в сетевой папке высокой доступности. Если сценарий находится в сетевой папке, убедитесь, что группа "Все" имеет для нее разрешение "Чтение", и запретите доступ к папке, чтобы исключить несанкционированное изменение файлов.

Если вы укажете скрипт предварительного обновления, убедитесь, что такие параметры, как ограничения времени (например, StopAfter), позволяют скрипту успешно выполняться. Эти ограничения задают временной интервал для всего процесса выполнения сценариев и установки обновлений.

PostUpdateScript нет Путь и имя файла для скрипта PowerShell, выполняемого после завершения обновления (после выхода узла из режима обслуживания). Расширение имени файла должно быть PS1 , а общая длина пути плюс имени файла не должна превышать 260 символов. Чтобы сценарий был всегда доступен для всех узлов кластера, рекомендуется размещать его на диске в системе хранения данных кластера или в сетевой папке высокой доступности. Если сценарий находится в сетевой папке, убедитесь, что группа "Все" имеет для нее разрешение "Чтение", и запретите доступ к папке, чтобы исключить несанкционированное изменение файлов.

Если вы указываете скрипт после обновления, убедитесь, что параметры, такие как ограничения времени (например, StopAfter), настроены для успешного выполнения скрипта. Эти ограничения задают временной интервал для всего процесса выполнения сценариев и установки обновлений.

ConfigurationName Данный параметр действует только при выполнении сценариев.

Если указать скрипт предварительного обновления или скрипт после обновления, но не указать имя конфигурации, используется конфигурация сеанса по умолчанию для PowerShell (Microsoft.PowerShell).

Указывает конфигурацию сеанса PowerShell, которая определяет сеанс, в котором выполняются скрипты (заданные preUpdateScript и PostUpdateScript), и могут ограничить команды, которые можно выполнить.
CauPluginName Microsoft.WindowsUpdatePlugin Данный параметр задает имя подключаемого модуля для просмотра или выполнения обновления, на использование которого настраивается обновление с поддержкой кластера. Дополнительные сведения см. в статье о работе подключаемых модулей обновления с поддержкой кластеров.
CauPluginArguments нет Набор пар name=value (аргументы) для используемого подключаемого модуля обновления, например:

Domain=Domain.local

Эти пары name=value должны быть значимыми для подключаемого модуля, указанного в CauPluginName.

Чтобы указать аргумент с помощью пользовательского интерфейса CAU, введите имя, нажмите клавишу TAB и введите соответствующее значение. Чтобы задать следующий аргумент, снова нажмите клавишу TAB. Каждое имя и значение автоматически отделяются знаком равного (=). Пары автоматически отделяются друг от друга точкой с запятой.

Для подключаемого модуля Microsoft.WindowsUpdatePlugin по умолчанию аргументы не требуются. При этом можно задать необязательный аргумент, например чтобы указать стандартную строку запроса для агента Центра обновления Windows, фильтрующую набор обновлений, которые применяются подключаемым модулем. Для имени используйте QueryString и для значения заключите полный запрос в кавычки.

Дополнительные сведения см. в статье о работе подключаемых модулей обновления с поддержкой кластеров.

Параметры, указанные при запросе запуска обновления

В следующей таблице перечислены параметры (отличные от параметров профиля выполнения обновления), которые указываются при запросе на выполнение обновления. Сведения о параметрах, задаваемых в профиле прогона обновления, см. в предыдущей таблице.

Вариант Default value Сведения
Имя кластера Ни один
Примечание. Этот параметр должен быть установлен только в том случае, если пользовательский интерфейс CAU не запущен на узле отказоустойчивого кластера или вы хотите ссылаться на отказоустойчивый кластер, отличный от того, где выполняется пользовательский интерфейс CAU.
NetBIOS-имя кластера, на котором следует выполнить прогон обновления.
Учетные данные Учетные данные текущей учетной записи Учетные записи администратора для целевого кластера, на котором будет выполнено обновление. Возможно, у вас уже есть необходимые учетные данные, если вы запускаете пользовательский интерфейс CAU (или открываете сеанс PowerShell, если используете командлеты CAU PowerShell) из учетной записи с правами администратора и разрешениями в кластере.
NodeOrder По умолчанию CAU начинает работу с узла с наименьшим количеством кластерных ролей, а затем переходит на следующие узлы в порядке возрастания числа кластерных ролей. Данный параметр задает узлы кластера в том порядке, в каком их следует обновить (если возможно).

Использование профилей запуска обновления

Каждый прогон обновления можно связать с особым профилем прогона обновления. Профиль запуска по умолчанию хранится в папке %windir%\cluster . Если вы используете пользовательский интерфейс CAU в удаленном режиме обновления, можно указать профиль запуска обновления во время применения обновлений или использовать профиль запуска обновления по умолчанию. Если вы используете CAU в режиме самостоятельного обновления, вы можете импортировать параметры из указанного профиля запуска обновления при настройке параметров самостоятельного обновления. В обоих случаях можно переопределить значения, отображаемые для параметров прогона обновления, в соответствии с актуальными потребностями. Параметры прогона обновления можно сохранить в виде профиля прогона обновления с тем же или с другим именем файла. В следующий раз при применении обновлений или настройке параметров самообновления CAU автоматически выберет ранее выбранный профиль прогона обновления.

Можно изменить существующий профиль запуска обновления или создать новый, выбрав "Создать или изменить профиль запуска " в пользовательском интерфейсе CAU.

Ниже приведены некоторые важные заметки об использовании профилей выполнения обновления:

  • Профиль запуска обновления не хранит сведения, относящиеся к кластеру, например учетные данные администратора. Если вы используете CAU в режиме самостоятельного обновления, профиль запуска обновления также не сохраняет сведения о самостоятельном обновлении расписания. Это позволяет использовать один профиль прогона обновления во всех отказоустойчивых кластерах определенного класса.
  • Если вы настраиваете параметры самостоятельного обновления с помощью профиля запуска обновления, а затем измените профиль с разными значениями для параметров обновления, конфигурация самостоятельного обновления не изменяется автоматически. Чтобы применить новые параметры прогона обновления, необходимо снова настроить параметры самообновления.
  • Редактор профилей запуска, к сожалению, не поддерживает пути к файлам, которые включают пробелы, такие как C:\Program Files. В качестве обходного решения сохраните скрипты предварительного и последующего обновления в пути, который не включает пробелы, или используйте PowerShell исключительно для управления профилями выполнения, помещая кавычки по пути при запуске Invoke-CauRun.

Эквивалентные команды Windows PowerShell

Параметры можно импортировать из профиля запуска обновления при выполнении командлета Invoke-CauRun, Add-CauClusterRole или Set-CauClusterRole.

В следующем примере выполняется проверка и полный запуск обновления в кластере с именем CONTOSO-FC1 с помощью параметров обновления, указанных в C:\Windows\Cluster\DefaultParameters.xml. Для остальных параметров командлета используются значения по умолчанию.

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

С помощью профиля прогона обновления можно повторять операции обновления отказоустойчивого кластера с одинаковыми параметрами для обработки исключений, ограничений по времени и других рабочих показателей. Так как эти параметры обычно относятся к классу отказоустойчивых кластеров, например "Все кластеры Microsoft SQL Server" или "Мои критически важные кластеры", может потребоваться назовите каждый профиль запуска обновления в соответствии с классом отказоустойчивых кластеров, с которыми он будет использоваться. Кроме того, можно организовать профиль прогона обновления для сетевой папки, которая доступна всем отказоустойчивым кластерам определенного класса в ИТ-организации.

Дополнительные справочники