Поделиться через

Обновление локальной среды Azure с помощью PowerShell

Область применения: Azure Local 2311.2 и более поздних версий

Внимание

Azure Local, версия 23H2 (выпуски 2311.2–2509) достигнет окончания поддержки 31 октября 2025 г. После этой даты вы не получите ежемесячные обновления безопасности и качества. Запросы на поддержку будут доступны только для обновления поддерживаемой версии.

В этой статье описывается, как применить обновление решения к локальному центру Azure с помощью PowerShell.

Процедура, описанная в этой статье, применяется как к системам с одним узлом, так и к системам с несколькими узлами, которые запускают последнюю версию Azure Local с установленным оркестратором (Lifecycle Manager). Если ваша система была создана с помощью нового развертывания Azure Local, оркестратор был автоматически установлен в рамках развертывания.

Внимание

Процедура, описанная здесь, применяется при обновлении существующей локальной версии Azure до более новой. Сведения об обновлениях для более старых версий см. в разделе "Обновление кластеров для Azure Stack HCI" версии 22H2.

Сведения об обновлениях решения

Обновления локального решения Azure могут состоять из обновлений расширения платформы, службы и решения. Дополнительные сведения о каждом из этих типов обновлений см. в разделе "Сведения об обновлениях для локальной сети Azure".

Внимание

На основе решения, которое вы используете для работы Azure Local, последние обновления функций могут стать видимыми через неделю после даты их доступности, из-за проверки и утверждения партнёров по оборудованию.

При применении обновления решения ниже приведены высокоуровневые действия.

  1. Убедитесь, что все требования выполнены.
  2. Подключитесь к локальному экземпляру Azure через удаленный powerShell.
  3. Проверьте текущие установленные версии программного обеспечения и убедитесь, что кластер находится в состоянии работоспособности.
  4. Откройте доступные обновления и отфильтруйте те, которые можно применить к системе.
  5. (Рекомендуется) Предварительно скачать обновления и оценить готовность вашей системы к обновлению.
  6. Установите обновления и отслеживайте ход выполнения обновлений. Отслеживайте подробный ход выполнения по мере необходимости.
  7. Проверьте версию установленных обновлений.
  8. Установите обновления оборудования.

Время установки обновлений зависит от следующих факторов:

  • Содержимое обновления.
  • Нагрузка на вашу систему.
  • Количество компьютеров в системе.
  • Тип используемого оборудования.
  • Используемое расширение решения.

Приблизительные оценки времени для типичной системы с одним или несколькими узлами приведены в следующей таблице:

Система/Время Время для проверки здоровья
HH:MM		 Время установки обновления
HH:MM
отдельный узел около 03:00 около 01:30
4 узла около 05:00 около 04:00

Внимание

Использование сторонних средств для установки обновлений не поддерживается.

Предварительные условия

Перед тем как начать, убедитесь в следующем.

  • У вас есть доступ к локальной системе Azure, работающей под управлением 2311 или более поздней версии. Система должна быть зарегистрирована в Azure.
  • У вас есть доступ к клиенту, который может подключиться к локальной службе Azure.
  • У вас есть доступ к обновлению решения по сети.

Подключение к локальной среде Azure

Выполните следующие действия на клиенте, чтобы подключиться к одному из компьютеров в локальной среде Azure.

  1. Запустите PowerShell от имени администратора на клиенте, который вы используете для подключения к системе.

  2. Откройте удаленный сеанс PowerShell на машине в вашей локальной сети Azure. Выполните следующую команду и укажите учетные данные компьютера при появлении запроса:

    $cred = Get-Credential
Enter-PSSession -ComputerName "<Computer IP>" -Credential $cred

    Примечание.

    Войдите с помощью учетных данных учетной записи пользователя для развертывания. Это учетная запись, созданная при подготовке Active Directory и используемая для развертывания локальной среды Azure.

    Разверните этот раздел, чтобы просмотреть пример выходных данных.

    Ниже представлен пример результата.

    PS C:\Users\Administrator> $cred = Get-Credential
 
cmdlet Get-Credential at command pipeline position 1
Supply values for the following parameters:
Credential
PS C:\Users\Administrator> Enter-PSSession -ComputerName "100.100.100.10" -Credential $cred 
[100.100.100.10]: PS C:\Users\Administrator\Documents>

Шаг 1. Подтверждение программного обеспечения и проверка работоспособности системы

Перед обнаружением обновлений убедитесь, что система работает под управлением Azure Local 2311 или более поздней версии.

  1. Убедитесь, что вы подключены к компьютеру с помощью учетной записи пользователя развертывания. Выполните следующую команду:

    whoami

  2. Чтобы убедиться, что система работает под управлением Azure Local 2311 или более поздней версии, выполните следующую команду на одном из компьютеров вашей системы:

    Get-SolutionUpdateEnvironment
    Разверните этот раздел, чтобы просмотреть пример выходных данных. 
    PS C:\Users\lcmuser> Get-SolutionUpdateEnvironment
ResourceId : redmond 
SbeFamily : GenA 
HardwareModel : Contoso680 
LastChecked : 10/2/2024 12:38:21 PM 
PackageVersions : {Solution: 10.2408.0.29, Services: 10.2408.0.29, Platform: 1.0.0.0, SBE: 4.1.2409.1} 
CurrentVersion : 10.2408.0.29 
CurrentSbeVersion : 4.1.2409.1 
LastUpdated : 
State : UpdateAvailable 
HealthState : Success 
HealthCheckResult : {Storage Subsystem Summary, Storage Pool Summary, Storage Services Physical Disks Summary, Storage 
Services Physical Disks Summary...} 
HealthCheckDate : 10/2/2024 10:46:44 AM 
AdditionalData :

  3. Обратите внимание на CurrentVersion в вашей системе. Текущая версия отражает версию решения, выполняемую системой.

  4. Проверьте HealthState в вашей системе и убедитесь, что система находится в хорошем состоянии. Если HealthState имеет Failure, Error или Warning, см. Устранение неполадок при проверке готовности перед продолжением.

Шаг 2. Обнаружение обновлений

Выполните следующие действия, чтобы обнаружить доступные обновления для системы:

  1. Подключитесь к машине в вашем локальном Azure с помощью учетной записи пользователя для развертывания.

  2. Просмотрите сведения об обновлениях, которые Ready предназначены для установки с помощью Get-SolutionUpdate.

    Get-SolutionUpdate | Where-Object {$_.State -like "Ready*" -or $_.State -like "Additional*"} | FL DisplayName, Description, ResourceId, State, PackageType
    Разверните этот раздел, чтобы просмотреть пример выходных данных.

    Ниже представлен пример результата.

    PS C:\Users\lcmuser> Get-SolutionUpdate | Where-Object {$_.State -like "Ready*" -or $_.State -like "Additional*"} | FL DisplayName, Description, ResourceId, State, PackageType

DisplayName           : 2024.10 Cumulative Update
ResourceId            : redmond/Solution10.2408.2.7
Version               : 10.2408.2.7
State                 : Ready
PackageType           : Solution

DisplayName           : SBE_Contoso_GenA_4.1.2410.5
ResourceId            : redmond/SBE4.1.2410.5
Version               : 4.1.2410.5
State                 : AdditionalContentRequired
PackageType           : SBE

    Может содержать один или несколько вариантов, включая полные Solution обновления (которые также могут включать расширение конструктора решений) и автономные SBE обновления.

    Если вы не видите ожидаемое обновление, удалите фильтр из команды, чтобы узнать, указан ли он в состоянии non-ready:

    Get-SolutionUpdate | FL DisplayName, Description, ResourceId, State, PackageType

    Дополнительные сведения см. в разделе "О этапах обновления " для получения подробных сведений о состояниях обновления.

  3. Выберите обновление, которое вы хотите установить, и отметьте его ResourceId. Просмотрите сведения об обновлении, чтобы убедиться, что вы выбрали требуемое обновление для установки.

    $Update = Get-SolutionUpdate –Id <ResourceId>
$Update
    Разверните этот раздел, чтобы просмотреть пример выходных данных.

    Ниже представлен пример результата.

    PS C:\Users\lcmuser> $Update = Get-SolutionUpdate –Id redmond/Solution10.2408.2.7
PS C:\Users\lcmuser> $Update
ResourceId            : redmond/Solution10.2408.2.7
InstalledDate         : 
Description           :
State                 : Ready
KbLink                : https://learn.microsoft.com/en-us/azure-stack/hci/
MinVersionRequired    : 10.2408.0.0
MinSbeVersionRequired : 2.0.0.0
PackagePath           : C:\ClusterStorage\Infrastructure_1\Shares\SU1_Infrastructure_1\Updates\Packages\Solution10.2408
                        .2.2
PackageSizeInMb       : 1278
DisplayName           : 2024.10 Cumulative Update
Version               : 10.2408.2.7
SbeVersion            : 4.1.2410.5
Publisher             : Microsoft
ReleaseLink           : https://learn.microsoft.com/en-us/azure-stack/hci/
AvailabilityType      : Online
PackageType           : Solution
Prerequisites         : {}
UpdateStateProperties : The update requires additional content distributed by the OEM.
AdditionalProperties  : {SBEReleaseLink, SBENotifyMessage, SBEFamily, SBEPublisher...}
ComponentVersions     : {Services: 10.2408.2.7, Platform: 10.2408.2.7, SBE: 4.1.2410.5}
RebootRequired        : Unknown
HealthState           : Unknown
HealthCheckResult     : 
HealthCheckDate       : 1/1/0001 12:00:00 AM
BillOfMaterials       : {PlatformUpdate, ServicesUpdate}

    Примечание.

    Нормально, если HealthState является Unknown для обновления, которое еще не запланировано или подготовлено.

  4. При необходимости просмотрите версии компонентов пакета обновления.

    $Update = Get-SolutionUpdate -Id <ResourceID>
$Update.ComponentVersions
    Разверните этот раздел, чтобы просмотреть пример выходных данных.

    Ниже представлен пример результата.

    PS C:\Users\lcmuser> $Update = Get-SolutionUpdate -Id redmond/Solution10.2408.2.7

PS C:\Users\lcmuser> $Update.ComponentVersions

PackageType Version      LastUpdated
----------- -------      -----------
Services    10.2408.2.7
Platform    10.2408.2.7
SBE         4.1.2410.5

PS C:\Users\lcmuser>

Шаг 3. Импорт и повторное обнаружение обновлений

Это необязательный шаг. Импорт обновлений может потребоваться в одном из следующих сценариев:

  • Обновление, которое вы хотите установить, сообщает о состоянии AdditionalContentRequired. Для планирования обновления в состоянии AdditionalContentRequiredможет потребоваться дополнительное содержимое. Дополнительные сведения об этом состоянии и обновлении расширений решения см. в разделе "Обновления расширения построителя решений" в локальной среде Azure.

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

  • Обновление отображается как Ready, но так как система имеет ограниченное сетевое подключение, вы хотите избежать этапа загрузки в сети обновления расширения решения.

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

  1. Подключитесь к машине в вашем локальном Azure с помощью учетной записи пользователя для развертывания.

  2. Перейдите в сетевую папку и получите пакет обновления, который вы используете. Убедитесь, что импортируемый пакет обновления содержит следующие файлы:

    • SolutionUpdate.xml
    • SolutionUpdate.zip
    • AS_Update_10.2408.2.7.zip

    Если расширение построителя решений является частью пакета обновления, вы также увидите следующие файлы:

    • SBE_Contoso_GenA_4.1.2410.5.xml
    • SBE_Contoso_GenA_4.1.2410.5.zip
    • SBE_Discovery_Contoso.xml

  3. Скачайте файлы, которые вы планируете импортировать в расположение, к которому может получить доступ локальный экземпляр Azure. Если вы импортируете расширение решения, вы всегда скачиваете три файла, соответствующие следующему шаблону именования:

    Шаблон имени файла Пример Описание
    SBE_Discovery_<Изготовитель>.xml SBE_Discovery_Contoso.xml Манифест обнаружения расширений решения, обеспечивающий обнаружение обновлений.
    SBE_<Производитель>_<Семейство>_<Версия>.xml SBE_Contoso_GenA_4.1.2410.5.xml Файл с инвентарным списком расширений решения и подписанной спецификацией материалов программного обеспечения
    SBE_<Производитель>_<Семейство>_<Версия>.zip SBE_Contoso_GenA_4.1.2410.5.zip Файл с полезной нагрузкой для расширения решения

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

    New-Item C:\ClusterStorage\Infrastructure_1\Shares\SU1_Infrastructure_1\import -ItemType Directory

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

  6. Обнаружение пакета обновления вручную с помощью службы обновления. Выполните следующую команду:

    Add-SolutionUpdate -SourceFolder C:\ClusterStorage\Infrastructure_1\Shares\SU1_Infrastructure_1\import

  7. Убедитесь, что служба обновления обнаруживает пакет обновления и доступен для запуска подготовки и установки. Повторите команду Get-SolutionUpdate для повторного обнаружения обновлений.

Вы можете скачать обновление и выполнить набор проверок, чтобы проверить готовность к обновлению кластера без запуска установки.

  1. Чтобы скачать обновления без запуска установки, выполните следующую команду:

    Get-SolutionUpdate -Id <ResourceId> | Start-SolutionUpdate –PrepareOnly
    Разверните этот раздел, чтобы просмотреть пример выходных данных.

    Ниже приведен пример выходных данных:

    PS C:\Users\lcmuser> Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 | Start-SolutionUpdate –PrepareOnly
redmond/SBE4.1.2410.9/<GUID>

  2. Чтобы отслеживать ход выполнения обновления, отслеживайте состояние обновления. Выполните следующую команду:

    Get-SolutionUpdate -Id <ResourceId> | ft Version,State,UpdateStateProperties,HealthState

    При запуске обновления выполняются следующие действия:

    • Начинается скачивание обновлений. В зависимости от размера пакета загрузки и пропускной способности сети загрузка может занять несколько минут.
    Разверните этот раздел, чтобы просмотреть пример выходных данных.

    Ниже приведен пример выходных данных при скачивании обновлений:

    PS C:\Users\lcmuser> Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 | ft Version,State,HealthState

Version              State          HealthState
-------              -----          ---------------------
10.2408.2.7          Downloading    InProgress

  3. После скачивания пакета проверки готовности выполняются для оценки готовности к обновлению системы. Дополнительные сведения о проверках готовности см. в разделе "Этапы обновления". На этом этапе состояние обновления отображается как HealthChecking.

    Разверните этот раздел, чтобы просмотреть пример выходных данных. 
    PS C:\Users\lcmuser> Get-SolutionUpdate|ft Version,State,UpdateStateProperties,HealthState

Version         State             HealthState
-------         -----             --------------------- 
10.2408.2.7     HealthChecking    InProgress

  4. После завершения проверок готовности система готова к установке обновлений. State обновления отображается как ReadyToInstall. State Если обновление отображается какHealthCheckFailed, см. сведения о проверке готовности к устранению неполадок перед продолжением.

Шаг 5. Запуск обновления

Во время установки системные компьютеры могут перезагружаться, и может потребоваться снова установить удаленный сеанс PowerShell для мониторинга обновлений. При обновлении одной машины ваш локальный экземпляр Azure испытывает временный простой.

Начните обновление, выбрав одно обновление и передав его в Start-SolutionUpdate.

$InstanceId = Get-SolutionUpdate -Id <ResourceId>  | Start-SolutionUpdate

Примечание.

Если шаг 4 был пропущен (и вы не сделали аналогичный вызов Start-SolutionUpdate -PrepareOnly) вызов Start-SolutionUpdate сначала загружает обновления и выполняет набор проверок для проверки готовности к обновлению кластера перед началом установки обновления.

Разверните этот раздел, чтобы просмотреть пример выходных данных. 
PS C:\Users\lcmuser> $InstanceId = Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 | Start-SolutionUpdate

Это запускает процесс установки обновления.

Совет

Сохраните $InstanceId, поскольку его можно будет использовать позже для устранения неполадок с обновлениями решения для локальной среды Azure.

Шаг 6. Отслеживание хода обновления

Корпорация Майкрософт рекомендует отслеживать ход обновления кластера на портале Azure после запуска обновления. Портал является отличным вариантом отслеживания хода выполнения обновления, даже если обновление запускается с помощью PowerShell, так как оно не зависит от сбоев в отчетах о состоянии.

Совет

  • При мониторинге с помощью PowerShell рекомендуется подключить сеанс PowerShell к последнему серверу в кластере, чтобы избежать отключения сеанса. Сеансы отключаются при перезагрузке систем, поэтому переключение на мониторинг с использованием уже обновленного сервера может минимизировать частоту отключений.
  • Рекомендуется отслеживать ход обновления кластера на портале Azure, чтобы избежать необходимости повторного подключения к сеансам PowerShell после перезагрузки компьютера.

Выполните следующие действия, чтобы отслеживать ход обновления с помощью PowerShell.

  1. Чтобы отслеживать ход выполнения обновления, отслеживайте состояние обновления. Выполните следующую команду:

    Get-SolutionUpdate -Id <ResourceId> | ft Version,State,UpdateStateProperties,HealthState

    Обновление переходит через несколько этапов, как описано в Обзор этапов обновления.

    В приведенных выше примерах команды показано, как отслеживать обновление по мере выполнения этих этапов с помощью свойств State и UpdateStateProperties.

    • Загрузка состояния

      Вскоре после вызова Start-SolutionUpdate начинается скачивание обновлений. В зависимости от размера пакета загрузки и пропускной способности сети загрузка может занять несколько минут.

      Разверните этот раздел, чтобы просмотреть пример выходных данных.

      Ниже приведен пример выходных данных при скачивании обновлений:

      PS C:\Users\lcmuser> Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 |ft Version,State,UpdateStateProperties,HealthState

Version              State         HealthState
-------              -----         ------------
10.2408.2.7          Downloading   Unknown

    • Состояние подготовки

      После загрузки обновлений их необходимо подготовить. В состоянии подготовки подтверждаются хэши файлов обновления, и файлы извлекаются для подготовки и развертывания обновлений.

      Разверните этот раздел, чтобы просмотреть пример выходных данных.

      Ниже приведен пример выходных данных при скачивании обновлений:

      PS C:\Users\lcmuser> Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 |ft Version,State,HealthState

Version              State       HealthState
-------              -----       -----------
10.2408.2.7          Preparing   Unknown

    • Состояние проверки состояния здоровья

      После подготовки обновлений проверки готовности выполняются для оценки готовности к обновлению кластера. Дополнительные сведения о проверках готовности см. в разделе "Этапы обновления".

      На этом этапе State обновления отображается как HealthChecking. State Если обновление отображается какHealthCheckFailed, см. сведения о проверке готовности к устранению неполадок перед продолжением.

      Разверните этот раздел, чтобы просмотреть пример выходных данных.

      Вот пример результата, когда обновления выполняются HealthChecking:

      PS C:\Users\lcmuser> Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 |ft Version,State,HealthState

Version              State           HealthState
-------              -----           -----------
10.2408.2.7          HealthChecking  Unknown

    • Состояние установки Когда система готова, обновление переходит в Installing. На этом этапе State обновлений отображается как Installing и UpdateStateProperties показывает процент завершенной установки.

      Разверните этот раздел, чтобы просмотреть пример выходных данных.

      Вот пример результата, когда обновления выполняются Installing:

      PS C:\Users\lcmuser> Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 |ft Version,State,HealthState

Version              State       HealthState
-------              -----       -----------
10.2408.2.7          Installing   Unknown

После завершения установкисостояние изменится на . Дополнительные сведения о различных состояниях обновлений см. в разделе "Ход установки" и "Мониторинг".

Шаг 7. Возобновление обновления (при необходимости)

Чтобы возобновить выполнение ранее неудачного обновления с помощью PowerShell, используйте следующую команду:

Get-SolutionUpdate -Id <ResourceId>  | Start-SolutionUpdate

Чтобы возобновить ранее неудачное обновление из-за проверок готовности к обновлению в состоянии Warning, используйте следующую команду:

Get-SolutionUpdate -Id <ResourceId>  | Start-SolutionUpdate -IgnoreWarnings

Сведения об устранении неполадок при выполнении других обновлений см. в разделе "Устранение неполадок".

Шаг 8. Проверка установки

После установки обновлений проверьте версию решения среды и версию операционной системы.

  1. Когда обновление находится в состоянии Installed, проверьте версию решения среды. Выполните следующую команду:

    Get-SolutionUpdateEnvironment | ft State, CurrentVersion
    Разверните этот раздел, чтобы просмотреть пример выходных данных. 
    PS C:\Users\lcmuser> Get-SolutionUpdateEnvironment | ft State, CurrentVersion

State               CurrentVersion
-----               --------------
AppliedSuccessfully 10.2408.2.7

  2. Проверьте версию операционной системы, чтобы подтвердить соответствие установленному рецепту. Выполните следующую команду:

    cmd /c ver
    Разверните этот раздел, чтобы просмотреть пример выходных данных.

    Ниже приведен пример выходных данных.

    PS C:\Users\lcmuser> cmd /c ver

Microsoft Windows [Version 10.0.25398.1189]
PS C:\Users\lcmuser>

Шаг 9. Установка обновлений оборудования

Существует несколько способов установки обновлений оборудования для локальной службы Azure в зависимости от того, что поддерживает локальный экземпляр Azure.

  • Расширение построителя решений
  • Центр администрирования Windows
  • Рекомендация поставщика оборудования

Расширение построителя решений

Для систем, поддерживающих расширения построителя решений:

  • При установке обновлений локальных функций Azure соответствующие обновления расширения Solution Builder автоматически включены.
  • Обновления расширения построителя решений можно установить отдельно (обновления оборудования можно установить без объединенного локального обновления Azure).

Центр администрирования Windows

Если оборудование не поддерживает процесс обновления расширения построителя решений, процесс обновления оборудования остается похожим на процесс, используемый в локальной версии Azure, версии 22H2. Это означает, что обновления оборудования могут быть доступны с помощью Центра администрирования Windows. Дополнительные сведения см. в разделе "Обновление локальной версии Azure" версии 22H2.

Рекомендация поставщика оборудования

Обновления встроенного ПО и драйверов могут потребоваться отдельно, если оборудование не поддерживает обновления оборудования с помощью пакетов расширений построителя решений или Windows Admin Center. Следуйте рекомендациям поставщика оборудования.

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

Следующий шаг