次の方法で共有

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 Local で作成されたシステムにソリューション更新プログラムを適用する方法については、「 Update Azure Local version 22H2」を参照してください。

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

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

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

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

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

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

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

システム/時刻 正常性チェックの時間
hh:mm:ss		 更新プログラムをインストールする時間
hh:mm:ss
単一ノード 0:01:44 1:25:42
4 ノード 0:01:58 3:53:09

前提条件

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

  • 2310 以降を実行している Azure Local バージョン 23H2 システムにアクセスできます。 システムは Azure に登録する必要があります。
  • Azure Local に接続できるクライアントにアクセスできます。 このクライアントは PowerShell 5.0 以降を実行している必要があります。
  • ネットワーク経由でソリューション更新プログラム パッケージにアクセスできます。 これらの更新プログラムをシステム内のマシンにインポートまたはコピーします。

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 ソフトウェア バージョン 2310 を使用してシステムがデプロイされていることを確認してください。

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

    whoami

  2. Azure Local バージョン 23H2 を実行してシステムがデプロイされたことを確認するには、システムのいずれかのマシンで次のコマンドを実行します。

    Get-StampInformation

    出力例を次に示します。

    PS C:\Users\lcmuser> Get-StampInformation
Deployment ID             : b4457f25-6681-4e0e-b197-a7a433d621d6
OemVersion                : 2.1.0.0
PackageHash               :
StampVersion              : 10.2303.0.31
InitialDeployedVersion    : 10.2303.0.26
PS C:\Users\lcmuser>

  3. システム上の StampVersion をメモしておきます。 スタンプのバージョンには、システムが実行されているソリューションのバージョンが反映されます。

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

更新プログラムは、次の 2 つの方法のいずれかで検出できます。

  • オンラインで更新プログラムを検出する - システムのインターネット接続が良好な場合に推奨されるオプションです。 ソリューションの更新プログラムは、オンライン更新プログラム カタログを介して検出されます。
  • 更新プログラムのインポートと検出 - オンラインで更新プログラムを検出する代わりに、信頼性の低い、または低速なインターネット接続のシナリオや、ハードウェア ベンダーによって提供されるソリューション拡張機能の更新プログラムを使用する場合に使用する必要があります。 これらのインスタンスでは、ソリューションの更新プログラムを中央の場所にダウンロードします。 その後、更新プログラムを Azure Local にインポートし、更新プログラムをローカルで検出します。

オンライン カタログを使用してソリューションの更新プログラムを検出することは、 recommended メソッドです。 ソリューションの更新プログラムをオンラインで検出するには、次の手順に従います。

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

  2. 更新サービスが更新プログラム パッケージを検出することを確認します。

    Get-SolutionUpdate | ft DisplayName, State

  3. 必要に応じて、更新プログラム パッケージ コンポーネントのバージョンを確認します。

    $Update = Get-SolutionUpdate | ? Version -eq "10.2302.0.31"
$Update.ComponentVersions

    出力例を次に示します。

     PS C:\Users\lcmuser> $Update = Get-SolutionUpdate | ? Version -eq "10.2302.0.31"
 PS C:\Users\lcmuser> $Update.ComponentVersions

PackageType Version      LastUpdated
----------- -------      -----------
Services    10.2303.0.31
Platform    10.2303.0.31
SBE         4.1.2.3
 PS C:\Users\lcmuser>

ダウンロードに進み、更新プログラムをインストールできます。

ソリューションの更新プログラムをインポートして検出する

ハードウェアからソリューション拡張機能の更新プログラムを使用している場合は、それらの更新プログラムをインポートする必要があります。 ソリューションの更新プログラムをインポートして検出するには、次の手順に従います。

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

  2. ネットワーク共有に移動し、使用する更新プログラム パッケージを取得します。 インポートする更新プログラム パッケージに次のファイルが含まれていることを確認します。

    • SolutionUpdate.xml
    • SolutionUpdate.zip
    • AS_Update_10.2303.4.1.zip

    ソリューション ビルダー拡張機能が更新プログラム パッケージの一部である場合は、次のファイルも表示されます。

    • SBE_Content_4.1.2.3.xml
    • SBE_Content_4.1.2.3.zip
    • SBE_Discovery_Contoso.xml

  3. システムのインフラストラクチャ ボリューム内の次の場所に、更新サービスによる検出用のフォルダーを作成します。

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

  4. 前の手順で作成したフォルダーに更新パッケージをコピーします。

  5. Update サービスを使用して更新プログラム パッケージを手動で検出します。 次のコマンドを実行します。

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

  6. 更新サービスが更新プログラム パッケージを検出し、準備とインストールを開始できるかどうかを確認します。

    Get-SolutionUpdate | ft DisplayName, Version, State

    出力例を次に示します。

     PS C:\Users\lcmuser> Get-SolutionUpdate | ft DisplayName, Version, State

DisplayName                 Version      State
-----------                 -------      -----
2023.03 Feature Update 10.2303.0.31 Ready

 PS C:\Users\lcmuser>

  7. 必要に応じて、更新プログラム パッケージ コンポーネントのバージョンを確認します。 次のコマンドを実行します。

    $Update = Get-SolutionUpdate | ? Version -eq "10.2302.0.31"
$Update.ComponentVersions

    出力例を次に示します。

     PS C:\Users\lcmuser> $Update = Get-SolutionUpdate | ? Version -eq "10.2302.0.31"
 PS C:\Users\lcmuser> $Update.ComponentVersions

PackageType Version      LastUpdated
----------- -------      -----------
Services    10.2303.0.31
Platform    10.2303.0.31
SBE         4.1.2.3
 PS C:\Users\lcmuser>

手順 3: ダウンロード、準備状況の確認、更新プログラムのインストール

更新プログラムをダウンロードし、一連のチェックを実行してシステムの更新の準備を確認し、更新プログラムのインストールを開始できます。

  1. インストールを開始せずに更新プログラムをダウンロードするか、更新プログラムをダウンロードしてインストールする必要があります。

    • 更新プログラムをダウンロードしてインストールするには、次のコマンドを実行します。

      Get-SolutionUpdate | ? Version -eq "10.2302.0.31" | Start-SolutionUpdate

    • インストールを開始せずに更新プログラムのみをダウンロードするには、-PrepareOnlyで Start-SolutionUpdate フラグを使用します。

  2. 更新の進行状況を追跡するには、更新の状態を監視します。 次のコマンドを実行します。

    Get-SolutionUpdate | ft Version,State,UpdateStateProperties,HealthState

    更新が開始されると、次のアクションが発生します。

    • 更新プログラムのダウンロードが開始されます。 ダウンロード パッケージのサイズとネットワーク帯域幅によっては、ダウンロードに数分かかる場合があります。

      更新プログラムのダウンロード時の出力例を次に示します。

        PS C:\Users\lcmuser> Get-SolutionUpdate|ft Version,State,UpdateStateProperties,HealthState

Version              State UpdateStateProperties HealthState
-------              ----- --------------------- -----------
10.2303.4.1 Downloading                        InProgress

    • パッケージがダウンロードされると、システムの更新の準備状況を評価するための準備チェックが実行されます。 準備チェックの詳細については、「 Update フェーズ」を参照してください。 このフェーズでは、更新プログラムの State が HealthCheckingとして表示されます。

      PS C:\Users\lcmuser> Get-SolutionUpdate|ft Version,State,UpdateStateProperties,HealthState

Version              State UpdateStateProperties HealthState
-------              ----- --------------------- -----------
10.2303.4.1 HealthChecking                        InProgress

    • システムの準備ができたら、更新プログラムがインストールされます。 このフェーズでは、更新プログラムの State は Installing として表示され、 UpdateStateProperties は完了したインストールの割合を示します。

      重要

      インストール中にマシンが再起動する可能性があり、更新プログラムを監視するためにリモート PowerShell セッションをもう一度確立する必要がある場合があります。 1 台のマシンを更新すると、Azure Local でダウンタイムが発生します。

      更新プログラムのインストール中の出力例を次に示します。

      PS C:\Users\lcmuser> Get-SolutionUpdate|ft Version,State,UpdateStateProperties,HealthState

Version          State UpdateStateProperties HealthState
-------          ----- --------------------- -----------
10.2303.4.1 Installing 6% complete.              Success


PS C:\Users\lcmuser> Get-SolutionUpdate|ft Version,State,UpdateStateProperties,HealthState

Version          State UpdateStateProperties HealthState
-------          ----- --------------------- -----------
10.2303.4.1 Installing 25% complete.             Success

PS C:\Users\lcmuser> Get-SolutionUpdate|ft Version,State,UpdateStateProperties,HealthState

Version          State UpdateStateProperties HealthState
-------          ----- --------------------- -----------
10.2303.4.1 Installing 40% complete.             Success

PS C:\Users\lcmuser> Get-SolutionUpdate|ft Version,State,UpdateStateProperties,HealthState

Version          State UpdateStateProperties HealthState
-------          ----- --------------------- -----------
10.2303.4.1 Installing 89% complete.             Success

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

手順 4: インストールを確認する

更新プログラムがインストールされたら、ソリューションのバージョンの環境とオペレーティング システムのバージョンを確認します。

  1. 更新が Installed 状態になってから、環境ソリューションのバージョンを確認します。 次のコマンドを実行します。

    Get-SolutionUpdateEnvironment | ft State, CurrentVersion

    出力例を次に示します。

    PS C:\Users\lcmuser> Get-SolutionUpdateEnvironment | ft State, CurrentVersion

State               CurrentVersion
-----               --------------
AppliedSuccessfully 10.2303.0.31

  2. インストールしたレシピと一致することを確認するには、オペレーティング システムのバージョンを確認します。 次のコマンドを実行します。

    cmd /c ver

    出力例を次に示します。

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

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

更新プログラムのトラブルシューティング

PowerShell を使用して以前に失敗した更新プログラムの実行を再開するには、次のコマンドを使用します。

Get-SolutionUpdate | ? Version -eq "10.2302.0.31" | Start-SolutionUpdate

Warning 状態の更新プログラムの正常性チェックが原因で、以前に失敗した更新プログラムを再開するには、次のコマンドを使用します。

Get-SolutionUpdate | ? Version -eq "10.2302.0.31" | Start-SolutionUpdate -IgnoreWarnings

その他の更新プログラムの実行に関する問題のトラブルシューティングについては、「Azure Local バージョン 23H2のソリューション更新プログラムのトラブルシューティング」を参照してください。

次のステップ

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