次の方法で共有

PowerShell を使用して Azure Local バージョン 23H2 を更新する

  • [アーティクル]

適用対象: Azure Local バージョン 23H2

この記事では、PowerShell を使用して Azure Local にソリューションの更新プログラムを適用する方法について説明します。

この記事の手順は、オーケストレーター (ライフサイクル マネージャー) がインストールされた最新バージョンの Azure Local を実行する単一ノード システムとマルチノード システムの両方に適用されます。 Azure Local バージョン 23H2 の新しいデプロイを使用してシステムが作成された場合、オーケストレーターはデプロイの一部として自動的にインストールされました。

重要

ここで説明する手順は、あるバージョンの Azure Local バージョン 23H2 から別の上位バージョンに更新する場合にのみ適用されます。 以前のバージョンの更新プログラムについては、「 Update clusters for Azure Local version 22H2」を参照してください。

ソリューションの更新プログラムについて

Azure ローカル ソリューションの更新プログラムは、プラットフォーム、サービス、およびソリューション拡張機能の更新プログラムで構成できます。 これらの種類の更新プログラムの詳細については、「 Azure Local バージョン 23H2 の更新プログラムについてを参照してください。

ソリューションの更新プログラムを適用する場合、実行する手順の概要を次に示します。

  1. すべての前提条件が完了していることを確認します。
  2. リモート PowerShell を使用して Azure ローカル インスタンスに接続します。
  3. 現在インストールされているソフトウェアのバージョンを確認し、クラスターの正常性が良好であることを確認します。
  4. 利用可能な更新プログラムを検出し、システムに適用できる更新プログラムをフィルター処理します。
  5. (推奨)更新プログラムを事前にダウンロードし、システムの更新の準備状況を評価します。
  6. 更新プログラムをインストールし、更新プログラムの進行状況を追跡します。 必要に応じて詳細な進行状況を監視します。
  7. インストールされている更新プログラムのバージョンを確認します。

更新プログラムのインストールにかかる時間は、次の要因によって異なります。

  • 更新プログラムの内容。
  • システムに読み込みます。
  • システム内のマシンの数。
  • 使用されるハードウェアの種類。
  • ソリューション拡張機能が使用されます。

一般的な単一または複数ノード システムのおおよその推定時間を次の表にまとめます。

システム/時刻 正常性チェックの時間
hh:mm:ss		 更新プログラムをインストールする時間
hh:mm:ss
単一ノード ～ 03:00 ～ 01:30
4 ノード ～ 05:00 ～ 04:00

重要

サード パーティ製ツールを使用して更新プログラムをインストールすることはできません。

前提条件

開始する前に次の点を確認します。

  • 2311 以降を実行している Azure Local バージョン 23H2 システムにアクセスできます。 システムは Azure に登録する必要があります。
  • Azure Local に接続できるクライアントにアクセスできます。
  • ネットワーク経由でソリューションの更新プログラムにアクセスできます。

Azure Local に接続する

クライアントで次の手順に従って、Azure Local 内のいずれかのマシンに接続します。

  1. システムへの接続に使用しているクライアントで、管理者として PowerShell を実行します。

  2. Azure Local 上のコンピューターへのリモート PowerShell セッションを開きます。 次のコマンドを実行し、メッセージが表示されたらコンピューターの資格情報を指定します。

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

    Note

    デプロイ ユーザー アカウントの資格情報を使用してサインインします。 これは、Active Directory 準備するときに作成し、Azure Local のデプロイに使用するアカウントです。

    このセクションを展開して、出力例を表示します。

    出力例を次に示します。

    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 以降が実行されていることを確認してください。

  1. デプロイ ユーザー アカウントを使用してマシンに接続していることを確認します。 次のコマンドを実行します。

    whoami

  2. システムが 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 :

  3. システム上の CurrentVersion に注意してください。 現在のバージョンには、システムが実行されているソリューションのバージョンが反映されます。

  4. システムの HealthState を確認し、システムの正常性が良好であることを確認します。 HealthState が Failure、Error、または Warning の場合は、先に進む前に「準備チェックのトラブルシューティング」を参照してください。

手順 2: 更新プログラムを検出する

システムで利用可能な更新プログラムを検出するには、次の手順に従います。

  1. デプロイ ユーザー アカウントを使用して、Azure Local 上のマシンに接続します。

  2. Get-SolutionUpdate を使用して、インストール状態が Ready の更新プログラムの詳細を確認します。

    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 更新プログラムの両方のエントリを含む 1 つ以上のオプションが一覧表示される場合があります。

    予想される更新プログラムが表示されない場合は、コマンドからフィルターを削除して、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}

    Note

    スケジュールまたは準備がまだされていない更新プログラムに対して、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 Local バージョン 23H2のソリューション拡張機能の更新プログラム を参照してください。

  • サポートが発生している問題に対処するためのプライベート リリースを提供しているため、インストールする更新プログラムが一覧に表示されません。

  • 更新プログラムは Readyとして表示されますが、システムのネットワーク接続が制限されているため、ソリューション拡張機能の更新プログラムのオンライン ダウンロード フェーズを回避する必要があります。

ソリューションの更新プログラムをインポートして検出するには、次の手順に従います。

  1. デプロイ ユーザー アカウントを使用して、Azure Local 上のマシンに接続します。

  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 ローカル インスタンスがアクセスできる場所にインポートするファイルをダウンロードします。 ソリューション拡張機能をインポートする場合は、次の名前付けパターンに一致する 3 つのファイルを常にダウンロードします。

    ファイル名パターン 例 説明
    SBE_Discovery_<Manufacturer>.xml SBE_Discovery_Contoso.xml 更新プログラムの検出を有効にするソリューション拡張機能検出マニフェスト。
    SBE_<Manufacturer>_<Family>_<Version>.xml SBE_Contoso_GenA_4.1.2410.5.xml ソリューション拡張機能インベントリと署名済みソフトウェア部品表を含むファイル
    SBE_<Manufacturer>_<Family>_<Version>.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. Update サービスを使用して更新プログラム パッケージを手動で検出します。 次のコマンドを実行します。

    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. パッケージがダウンロードされると、システムの更新の準備状況を評価するための準備チェックが実行されます。 準備チェックの詳細については、「 Update フェーズ」を参照してください。 このフェーズでは、更新プログラムの State が 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 セッションをもう一度確立することが必要になる場合があります。 1 台のマシンを更新すると、Azure Local でダウンタイムが発生します。

更新を開始するには、1 つの更新プログラムを選択し、Start-SolutionUpdateに渡します。

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

Note

手順 4 がスキップされた場合 (および、Start-SolutionUpdate -PrepareOnlyと同様の呼び出しを行わなかった場合)、Start-SolutionUpdate 最初に更新プログラムをダウンロードし、更新プログラムのインストールを開始する前にクラスターの更新の準備状態を確認するための一連のチェックを実行します。

このセクションを展開して、出力例を表示します。 
PS C:\Users\lcmuser> $InstanceId = Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 | Start-SolutionUpdate

これにより、更新プログラムをインストールするプロセスが開始されます。

ヒント

後で Azure Localのソリューション更新プログラムのトラブルシューティングを するために使用できるように、 を保存します。

手順 6: 更新の進行状況を追跡する

Microsoft では、更新が開始された後、Azure portal でクラスターの更新の進行状況を追跡することをお勧めします。 ポータルは、更新プログラムが PowerShell を使用して開始された場合でも、状態レポートの中断の影響を受けず、更新の進行状況を追跡するための優れたオプションです。

ヒント

  • PowerShell を使用して監視する場合は、セッションが早期に切断されないように、PowerShell セッションをクラスター内の最後のサーバーに接続することをお勧めします。 システムの再起動時にセッションが切断されるため、既に更新されたサーバーから監視に切り替えると、切断の頻度を最小限に抑えることができます。
  • マシンの再起動後に PowerShell セッションに再接続する必要がないように、Azure portal でクラスターの更新の進行状況を追跡することをお勧めします。

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

    • ヘルスチェック中状態

      更新プログラムが準備されると、準備状況チェックが実行され、クラスターの更新の準備状況が評価されます。 準備チェックの詳細については、「 Update フェーズ」を参照してください。

      このフェーズでは、更新プログラムの 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

インストールが完了すると、 State が Installedに変わります。 更新プログラムのさまざまな状態の詳細については、「 インストールの進行状況と監視を参照してください。

手順 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>

次のステップ

  • 更新プロセス中に問題が発生した場合は、「更新プログラムのトラブルシューティング」を参照してください。

  • オーケストレーターがインストールされていない場合にバージョン 22H2 を 更新する方法について説明します。