PowerShell を使用してAzure Localを更新する

適用対象: Azure Localの Hyperconverged 展開

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

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

Important

ここで説明する手順は、既存のAzure Localバージョンを新しいバージョンに更新するときに適用されます。

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

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

Important

Azure Localの実行に使用しているソリューションに基づいて、ハードウェア パートナーの検証とサインオフにより、最新の機能更新プログラムが表示されるまでに 1 週間かかる場合があります。

ソリューションの更新プログラムを適用する場合は、次の大まかな手順に従います。

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

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

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

次の表は、一般的な単一ノードまたはマルチノード システムのおおよその推定時間をまとめたものです。

System/Time 健康診断の時間です
hh:mm		 更新プログラムをインストールする時間
hh:mm
単一ノード ~ 00:17 ～ 04:00
4-nodes ~ 00:22 ~ 06:00

Important

サード パーティ製ツールを使用した更新プログラムのインストールはサポートされていません。

Prerequisites

開始する前に、次の前提条件を満たしていることを確認してください。

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

Azure Localに接続する

Note

クライアントで次の手順に従って、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 2311 以降を実行していることを確認してください。

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

    whoami

  2. システムが 2311 以降Azure Local実行されていることを確認するには、システム内のいずれかのマシンで次のコマンドを実行します。

    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. 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 更新プログラムの両方のエントリを含む、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 状態を報告します。 更新プログラムをスケジュールする前に、追加のコンテンツが必要になる場合があります。 この状態とソリューション拡張機能の更新プログラムの詳細については、「Azure Local の Solution Builder 拡張機能の更新プログラム」を参照してください。

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

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

    ファイル名パターン Example Description
    SBE_ディスカバリー_<製造元>.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. 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 と表示される場合は、先に進む前に「準備チェックのトラブルシューティング」を参照してください。

Note

-PrepareOnly パラメーターを使用して更新準備を実行した場合は、PowerShell を使用して更新する必要があります。 Azure ポータルに移動して更新プログラムを開始することはサポートされていないため、予期しない問題が発生する可能性があります。

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

このコマンドは、更新プログラムをインストールするプロセスを開始します。

Tip

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

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

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

Tip

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

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

インストールが完了すると、 状態 が 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>

手順 9: ハードウェア更新プログラムをインストールする

Azure Local インスタンスでサポートされている内容に応じて、Azure Localのハードウェア更新プログラムをインストールする方法はいくつかあります。

  • ソリューション ビルダー拡張機能
  • Windows Admin Center
  • ハードウェア ベンダーの推奨事項

ソリューション ビルダー拡張機能

ソリューション ビルダー拡張機能をサポートするシステムの場合:

  • Azure Local機能更新プログラムをインストールすると、適切なソリューション ビルダー拡張機能の更新プログラムが自動的に含まれます。
  • ソリューション ビルダー拡張機能の更新プログラムは個別にインストールできます (ハードウェア更新プログラムは、Azure Localの更新プログラムを組み合わさずにインストールできます)。

Windows Admin Center

ハードウェアがソリューション ビルダー拡張機能の更新エクスペリエンスをサポートしていない場合、ハードウェアを更新するプロセスは、Azure Local バージョン 22H2 で使用されるプロセスと同様です。 つまり、Windows Admin Centerを使用してハードウェア更新プログラムを利用できる可能性があります。 詳細については、「Update Azure Local バージョン 22H2を参照してください。

ハードウェア ベンダーの推奨事項

ハードウェアが Solution Builder 拡張機能パッケージまたはWindows Admin Centerを使用したハードウェア更新プログラムをサポートしていない場合は、ファームウェアとドライバーの更新プログラムを個別に実行する必要がある場合があります。 ハードウェア ベンダーの推奨事項に従います。

システムがソリューション ビルダー拡張機能をサポートしているかどうかを確認し、ハードウェア更新プログラムのインストールの詳細については、「 ソリューション ビルダー拡張機能のソフトウェア更新プログラムについて」を参照してください。

次のステップ

  • Last updated on