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

Статья
12/30/2024

Область применения: Локальная версия Azure, версия 23H2

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

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

Внимание

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

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

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

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

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

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

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

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

Система или время	Время проверки работоспособности hh:mm:ss	Время установки обновления hh:mm:ss
отдельный узел;	~ 03:00	~ 01:30
4-узлы	около 05:00	~ 04:00

Внимание

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

Необходимые компоненты

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

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

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

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

Запустите PowerShell от имени администратора на клиенте, который вы используете для подключения к системе.
Откройте удаленный сеанс 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 версии 23H2, программное обеспечение версии 2311 или более поздней.

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

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

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 :

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

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

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

Подключитесь к компьютеру на локальном компьютере Azure с помощью учетной записи пользователя развертывания.
Просмотрите сведения об обновлениях, которые 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 
```
Дополнительные сведения см. в разделе Этапы обновления для подробной информации о состояниях обновления.

Выберите обновление, которое вы хотите установить, и запишите его 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}

Примечание.

Обычно HealthStateUnknown для обновления, которое еще не запланировано или подготовлено.

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

$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 версия 23H2.
Обновление, которое вы хотите установить, не указано, так как поддержка предоставляет вам частный выпуск для решения проблемы, которую вы испытываете.
Обновление отображается как Ready, но так как система имеет ограниченное сетевое подключение, вы хотите избежать этапа загрузки в сети обновления расширения решения.

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

Подключитесь к компьютеру на локальном компьютере Azure с помощью учетной записи пользователя развертывания.
Перейдите к сетевой папке и получите используемый пакет обновления. Убедитесь, что импортируемый пакет обновления содержит следующие файлы:
- 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

Скачайте файлы, которые вы планируете импортировать в расположение, к которому может получить доступ локальный экземпляр 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	Файл с полезными данными расширения решения

Создайте папку для обнаружения службой обновления в следующем расположении в томе инфраструктуры системы.
```
New-Item C:\ClusterStorage\Infrastructure_1\Shares\SU1_Infrastructure_1\import -ItemType Directory 
```
Скопируйте файлы обновления в папку, созданную на предыдущем шаге.
Обнаружение пакета обновления вручную с помощью службы обновления. Выполните следующую команду:
```
Add-SolutionUpdate -SourceFolder C:\ClusterStorage\Infrastructure_1\Shares\SU1_Infrastructure_1\import
```
Убедитесь, что служба обновления обнаруживает пакет обновления и доступен для запуска подготовки и установки. Повторите команду Get-SolutionUpdate для повторного обнаружения обновлений.

Шаг 4. (Рекомендуется) Предварительная загрузка и проверка готовности к обновлению

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

Чтобы скачать обновления без запуска установки, выполните следующую команду:
```
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>
```
Чтобы отслеживать ход выполнения обновления, отслеживайте состояние обновления. Выполните следующую команду:
```
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
```
После скачивания пакета проверки готовности выполняются для оценки готовности к обновлению системы. Дополнительные сведения о проверках готовности см. в разделе "Этапы обновления". На этом этапе состояние обновления отображается как HealthChecking.
Разверните этот раздел, чтобы просмотреть пример выходных данных.
```
PS C:\Users\lcmuser> Get-SolutionUpdate|ft Version,State,UpdateStateProperties,HealthState

Version         State             HealthState
-------         -----             --------------------- 
10.2408.2.7     HealthChecking    InProgress
```
После завершения проверок готовности система готова к установке обновлений. 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.

Чтобы отслеживать ход выполнения обновления, отслеживайте состояние обновления. Выполните следующую команду:
```
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
```
- состояние HealthChecking
  
  После подготовки обновлений проверки готовности выполняются для оценки готовности к обновлению кластера. Дополнительные сведения о проверках готовности см. в разделе "Этапы обновления".
  
  На этом этапе 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
```

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

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

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

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

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

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

См. статью Устранение проблем при обновлениидля устранения других проблем с обновлением.

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

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

После завершения обновления Installed проверьте версию решения среды. Выполните следующую команду:
```
Get-SolutionUpdateEnvironment | ft State, CurrentVersion
```
Разверните этот раздел, чтобы просмотреть пример выходных данных.
```
PS C:\Users\lcmuser> Get-SolutionUpdateEnvironment | ft State, CurrentVersion

State               CurrentVersion
-----               --------------
AppliedSuccessfully 10.2408.2.7
```
Проверьте версию операционной системы, чтобы подтвердить соответствие установленному рецепту. Выполните следующую команду:
```
cmd /c ver
```
Разверните этот раздел, чтобы просмотреть пример выходных данных.

Ниже приведен пример выходных данных.
```
PS C:\Users\lcmuser> cmd /c ver

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

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

Если во время процесса обновления возникают проблемы, см. раздел "Устранение неполадок обновления".
Узнайте больше о том, как обновить версию 22H2, когда оркестратор не установлен.

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

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

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

Необходимые компоненты

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

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

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

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

Шаг 4. (Рекомендуется) Предварительная загрузка и проверка готовности к обновлению

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

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

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

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

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

Обратная связь

Дополнительные ресурсы