Azure MarketPlace のイメージから直接デプロイした VM (AVD) を全自動で日本語化する

Last updated at 2024-08-07Posted at 2023-09-06

はじめに

現在は、Azure Virtual Desktop (AVD) で、ホストプールと仮想マシンを作成する際に、どれだけシンプルな画面からデプロイさせられるか？を研究しています。
その際には、いくつかのハードルがあったのですが、そこで得られたノウハウを記事にしていこうと思っています。

今回は、Azure Market Place で提供されているマルチセッションの OSイメージを選択して VM をデプロイした際に、全自動でイメージが日本語化され、展開直後からユーザーが利用できるようにする方法を共有したいと思います。

なお、AVD用のマルチセッションの OSイメージは英語版ですが、プレインストールされている Office 365 のアプリも英語版です。
OS の日本語化に加えて、Office の日本語化も合わせて行う必要があって、苦労した点です。

本件を確立させる前の研究段階で、Azure VM をデプロイ時に全自動で日本語化に取り組んだ際の記事も掲載しています。併せて参照いただけると幸いです。

基本的には、上記の記事をベースとして、以下の３点を追加で対応させた進化版が本記事の内容となっています。

Office365アプリの日本語化を追加
処理中のログ出力に対応させた
AVDのデプロイ時に処理が可能なことを検証済み（50回以上のデプロイ実績あり）

当スクリプトを作成することにした経緯

AVD のような VDI の構築・運用・管理にはゴールデンイメージの作成と管理がつきものです。
このゴールデンイメージを作り始めると数多くのバージョンが生み出されて管理が煩雑になります。
従来から、ゴールデンイメージを使わない前提での VDIサービスの提供を考えられないか・・・と思っていたので、このたび本テーマに取り込みました。

この仕組みのメリット

コマンドが羅列されただけのスクリプトで構成（条件分岐や繰り返し処理が無く、全体像を理解しやすい）
スクリプト内にログオンアカウントの記載が不要
Windows10/11 共通で使用できる
GUI操作で日本語化した時の結果と比べて遜色ない仕上がり
Market Place で提供されている AVD用マルチセッションイメージから自由に選んでデプロイできる
デプロイ時の進捗を共有フォルダにログとして出力します。

前提事項

この記事では、オンプレミスのドメインコントローラーに参加する方式を前提としています。

以下の記事を参照して、No.1 ～ No.7 までを行い、AVD がデプロイされている必要があります。。

No.8 が本記事です。
No.9 以降の実施でより高度な AVD を構成できるような構成になっています。

VM イメージの要件

OSは、Windows 10 20H2以降と、Windows 11 のみ対応（その他の OS では不可）
処理時間は、D2sV3 の VM で、合計約 60 分程度掛かります。
（内訳）
　OS言語パック導入で約 10 分
　Office日本語化で約 10 分
　Windows Updateで長いと 40分（元のイメージによって変動）
スクリプトは、セッションホストのVMデプロイ時にカスタム構成スクリプトを使って実行する

カスタム構成スクリプトの内容

以下のスクリプトをストレージアカウント上に BLOB として保存しておき、AVDデプロイ時にカスタム構成スクリプトURL を指定することで実行できます。
スクリプトの配置方法は後述しています。

# ログのパス設定
$FILENAME = $env:Computername
$log = "\\[共有フォルダのパス]\DeployLog\" + $FILENAME + ".log"

# 開始
echo "Delpoy Start" >> $log

# タイムゾーン
echo "#1 Time Zone" >> $log
Set-TimeZone -Id "Tokyo Standard Time" >> $log
date >> $log
Get-TimeZone >> $log

# 言語パックインストール
echo "#2 OS LanguagePack Install" >> $log
date >> $log
Install-Language ja-jp >> $log

# システムロケール
echo "#3 System Locale" >> $log
date >> $log
Set-WinSystemLocale -SystemLocale ja-JP >> $log
Get-WinSystemLocale  >> $log

# 地域設定
echo "#4 Locale Setting" >> $log
date >> $log
Set-Culture -CultureInfo ja-JP >> $log
Get-Culture >> $log

# システム優先言語
echo "#5 System Preferred UI Language" >> $log
date >> $log
Set-SystemPreferredUILanguage ja-JP >> $log
Get-SystemPreferredUILanguage >> $log

# ロケーション
echo "#6 Location" >> $log
date >> $log
Set-WinHomeLocation -GeoId 0x7a >> $log
Get-WinHomeLocation >> $log

# 言語リスト
echo "#7 Language List" >> $log
date >> $log
$mylang = New-WinUserLanguageList -Language "ja-JP"
Set-WinUserLanguageList $mylang -Force >> $log
Get-WinUserLanguageList >> $log

# ようこそ画面をコピー
echo "#8 Welcome Display Copy" >> $log
date >> $log
Install-Language ja-jp -CopyTosettings >> $log

# Office言語パック（日本語）インストール
echo "#9 Office Language Pack (ja-jp) Install" >> $log
date >> $log
\\[共有フォルダのパス]\ODT\setup.exe /configure \\[共有フォルダのパス]\ODT\OfficeLanguagePackOnlySilent.xml

# Windows Update ※AutoRebootが掛かると 後続バッチが動作しないので必ず最後の処理にすること
echo "#10 Windows Update" >> $log
date >> $log
Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force >> $log
Install-Module PSWindowsUpdate -Force >> $log
Get-WindowsUpdate -AcceptAll -Install -AutoReboot >> $log

# 終了時刻の記録
echo "Deploy Finished" >> $log
date >> $log

注意事項

そこそこシンプルなスクリプトだと思いますが、各コマンドの順序やパラメーターに重要な意味があります。改変すると期待通りに動作しない恐れがあります。
完成までに相当な検証工数を掛けてバランス調整していますので、基本的には上記の内容でそのままご使用ください。
Windows Update と再起動の部分を省いて利用すると約20分で完了しますが、この場合は初回ログオン時に完全に日本語化されているように見えますが、OS再起動後に RDP ができなくなります。本事象を Microsoftサポートに問い合わせたところ、Windows Update の実行が必須であるとのアドバイスをうけ、Windows Update の最適な処理を研究して追加しさらに検証と調整を重ねて完成に至っています。

【MicrosoftサポートBlog：言語パックインストール時のご留意点】
https://jpwinsup.github.io/blog/2022/06/22/UserInterfaceAndApps/LanguageSupport_IME/lp-consideration/

スクリプトなどの仕込み作業（初回のみ）

カスタム構成スクリプトの仕込み

前章に記載していたカスタム構成スクリプトをテキストエディタへコピー＆ペーストして、ファイル (拡張子は .ps1) として任意のフォルダに保存します。
Azure上にストレージアカウントを新規作成します。既に運用中のストレージアカウントでも構いません。
・リソースグループ：任意
・ストレージアカウント名：任意（グローバルでユニーク）
　※サブスク利用者で共用して使う場合、ソート順で一番上に表示されるような名称にすることをお勧めします。
・冗長性：任意
　※ローカル冗長ストレージ(LRS) で十分　※一番安価なコストで利用できます。
ストレージアカウントがデプロイ出来たら、「ストレージブラウザー」－「BLOBコンテナー」を選択して、「＋コンテナーを追加する」をクリック
判りやすい任意のコンテナ名を付与して、「作成」をクリック
コンテナーが作成されたら、そのコンテナ名をクリック
下線のとおり、コンテナ名が表示されている事を確認して、「アップロード」をクリック
BLOBのアップロード画面で「ファイルの参照」をクリック
ファイル選択ダイアログで、あらかじめ保存しておいたスクリプトを選択して「開く」をクリック
下線部の通りにファイルが選択されている事を確認して「アップロード」をクリック
アップロードに成功すると、下線部の通りに表示される。これで事前準備は OK

Office 365 アプリの日本語化（Office展開ツール）の仕込み

Office365アプリを全自動スクリプトで日本語化する方法ですが、試行錯誤した結果、Office展開ツール(ODT) を採用することにしました。

任意の共有フォルダを作成して、この章の内容を構成してください（AD DS 上に作成するのが楽です）

VMイメージに Officeが導入されている時だけそのプロダクトを日本語化させたかったのですが、Product ID に Office製品のバージョンを指定してしまうと Officeが入っていないVMイメージにまで Officeが導入されてしまいます。

試行錯誤した結果、下記のように LanguagePack のみを指定することで、Officeが導入されていれば日本語化し、無ければ無視・・・という一番ベストな形で動作することが判りました。
ここで使用する Configファイル(xml) について、最終的に以下の内容になりました。

<Configuration>
  <Add>
    <Product ID="LanguagePack">
      <Language ID="ja-jp" />
    </Product>
  </Add>
  <Display Level="None" AcceptEULA="TRUE" />
</Configuration>

Office展開ツール（setup.exe）と、上記の構成ファイル（メモ帳に転記して OfficeLanguagePackOnlySilent.xml というファイル名で保存）を下図の通り共有フォルダに保存しておき。AVDをデプロイする際のカスタム構成スクリプトから実行させることで、連係動作するようになります。

フォルダのアクセス許可は、以下の通り（Everyone は、読み取りと実行のみにする）

フォルダの共有アクセス許可は、以下の通り（Everyone フルコントロールで問題ない）

カスタム構成スクリプトから起動する際のコマンドは、以下の通りです。

\\[共有フォルダのパス]\ODT\setup.exe /configure \\[共有フォルダのパス]\ODT\OfficeLanguagePackOnlySilent.xml

ログフォルダの仕込み

スクリプトの実行状態を把握するために、ログを保存できる仕組みを用意します。
スクリプトの実行中にエラーになった場合などに活用する事ができますし、デプロイ中に待っている際にも、ログをみることで、どこまで進捗しているのかが判りやすくなります。

DeployLog という名称の共有フォルダを作成しておきます。
※AD DS 上に作成してしまうのが楽です。

共有アクセス権は、以下の通りです。

あとは、カスタム構成スクリプトが実行される際にリアルタイムでホスト名ごとのログが追記されていきます。

ログは、以下のような内容で出力されます（本サイトで見やすいように若干成形しています）

Delpoy Start
#1 Time Zone
Monday, August 28, 2023 3:40:45 PM

Id                         : Tokyo Standard Time
DisplayName                : (UTC+09:00) Osaka, Sapporo, Tokyo
StandardName               : Tokyo Standard Time
DaylightName               : Tokyo Daylight Time
BaseUtcOffset              : 09:00:00
SupportsDaylightSavingTime : False

#2 OS LanguagePack Install
Monday, August 28, 2023 3:40:45 PM

Language Language Packs  Language Features                                               -------- --------------  -----------------                                               ja-JP    LpCab           BasicTyping, Handwriting, Speech, TextToSpeech, OCR             

#3 System Locale
Monday, August 28, 2023 4:14:52 PM

LCID             Name             DisplayName                                            ----             ----             -----------                                            1033             en-US            English (United States)                                

#4 Locale Setting
Monday, August 28, 2023 4:14:52 PM

LCID             Name             DisplayName                                            
----             ----             -----------                                            1033             en-US            English (United States)                                

#5 System Preferred UI Language
Monday, August 28, 2023 4:14:53 PM

ja-JP

#6 Location
Monday, August 28, 2023 4:14:53 PM

GeoId HomeLocation
----- ------------
  122 Japan       

#7 Language List
Monday, August 28, 2023 4:14:53 PM

LanguageTag     : ja
Autonym         : 日本語
EnglishName     : Japanese
LocalizedName   : Japanese
ScriptName      : Japanese
InputMethodTips : {0411:{03B5835F-F03C-411B-9CE2-AA23E1171E36}{A76C93D9-5523-4E90-AAFA-4DB112F9AC76}}
Spellchecking   : True
Handwriting     : True

#8 Welcome Display Copy
Monday, August 28, 2023 4:14:54 PM

Language Language Packs  Language Features                                               -------- --------------  -----------------                                               ja-JP    LpCab           BasicTyping, Handwriting, Speech, TextToSpeech, OCR             

#9 Office Language Pack (ja-jp) Install
Monday, August 28, 2023 4:15:02 PM

#10 Windows Update
Monday, August 28, 2023 4:19:50 PM

Name                           Version          Source           Summary                 ----                           -------          ------           -------                 nuget                          2.8.5.208        https://onege... NuGet provider for the OneGet meta-package manager

X ComputerName Result     KB          Size Title                                         - ------------ ------     --          ---- -----                                         1 AVD082803... Accepted   KB890830    57MB 悪意のあるソフトウェアの削除ツール x64 - v5.116 (KB890830)                                   
1 AVD082803... Accepted   KB5029718   60MB .NET Framework 3.5 用の2023-08累積的な更新プログラムのプレビューと x64 (KB5029718) のWindows 1...
1 AVD082803... Accepted   KB5007651   18MB Windows Security platform マルウェア対策プラットフォームの更新プログラム - KB5007651 (Version 1....
1 AVD082803... Accepted   KB2267602  137MB Microsoft Defender Antivirus のセキュリティ インテリジェンス更新プログラム - KB2267602 (バージョン 1...
1 AVD082803... Accepted   KB5029263  128GB 2023-08 x64 ベース システム用 Windows 11 Version 22H2 の累積更新プログラム (KB5029263)        
2 AVD082803... Downloaded KB890830    57MB 悪意のあるソフトウェアの削除ツール x64 - v5.116 (KB890830)                                   
2 AVD082803... Downloaded KB5029718   60MB .NET Framework 3.5 用の2023-08累積的な更新プログラムのプレビューと x64 (KB5029718) のWindows 1...
2 AVD082803... Downloaded KB5007651   18MB Windows Security platform マルウェア対策プラットフォームの更新プログラム - KB5007651 (Version 1....
2 AVD082803... Downloaded KB2267602  137MB Microsoft Defender Antivirus のセキュリティ インテリジェンス更新プログラム - KB2267602 (バージョン 1...
2 AVD082803... Downloaded KB5029263  128GB 2023-08 x64 ベース システム用 Windows 11 Version 22H2 の累積更新プログラム (KB5029263)        
3 AVD082803... Installed  KB890830    57MB 悪意のあるソフトウェアの削除ツール x64 - v5.116 (KB890830)                                   
3 AVD082803... Installed  KB5029718   60MB .NET Framework 3.5 用の2023-08累積的な更新プログラムのプレビューと x64 (KB5029718) のWindows 1...
3 AVD082803... Installed  KB5007651   18MB Windows Security platform マルウェア対策プラットフォームの更新プログラム - KB5007651 (Version 1....
3 AVD082803... Installed  KB2267602  137MB Microsoft Defender Antivirus のセキュリティ インテリジェンス更新プログラム - KB2267602 (バージョン 1...
3 AVD082803... Installed  KB5029263  128GB 2023-08 x64 ベース システム用 Windows 11 Version 22H2 の累積更新プログラム (KB5029263)        


Deploy Finished

Monday, August 28, 2023 4:27:29 PM

AVD デプロイ手順

Azure Virtual Desktop の「ホストプールを作成する」にて「仮想マシン」を作成する際に、カスタム構成スクリプトのURL を指定します（前章でBLOBに保存したスクリプトのURLを設定する）
デプロイが始まると、以下の画面になり、約60分程度待つと処理が終了します。

ユーザーの割り当て

デプロイが終わったら、以下の記事を参照して作成されたアプリケーショングループにユーザーを割り当てます。

初回サインイン

下図のように、初めから日本語化された状態でサインインができます。
※プレインストール済みの Officeアプリを起動したところ

参考にしたサイト

【言語パックの管理に便利な PowerShell コマンドレットのご紹介】
https://jpwinsup.github.io/blog/2023/03/06/UserInterfaceAndApps/LanguageSupport_IME/InstallLanguage/
→　このサイトを発見したことがこの取り組みを実施するきっかけになりました。しかしながらこのコマンドだけだと VMデプロイ時に組み込むと RDP できなくなったり不具合に見舞われてしまい、成功パターンを作り上げるためにこんなに苦労するとは思っていませんでした。
※ブログ記事には、下記の「ご留意点」を実施しなくても OK と書かれてはいるのですけどね。

【MicrosoftサポートBlog：言語パックインストール時のご留意点】
https://jpwinsup.github.io/blog/2022/06/22/UserInterfaceAndApps/LanguageSupport_IME/lp-consideration/
→　Microsoftサポートに問合せして、上記の記事のアドバイスを受けられなかったら完成することはできず、ずっとハマったままだったかもしれません。大変参考になりました。

【PowerShell】Windows Updteを自動化
https://boonx4m312s.hatenablog.com/entry/2023/02/02/180000
→　Windows Update をコマンドで全自動化する方法は、ネットで調べるといくつかの方法がみつかるのですが、VM デプロイ時に組み込もうとすると、うまく動作させられずなかなか良い方法がありませんでした。そんな中でこの記事で紹介されていた NuGetプロバイダーインストール時の一時中断を回避する方法が決め手となり、採用に至りました。
Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force
なお、バージョン(2.8.5.201) を固定で指定している箇所は、今後永続的に使えるかどうかが定かではなくちょっと気持ち悪い気がしており改変の余地があると考えています。もっと良い方法をご存じの方がいたら、コメント欄で教えてください。

【Azure コラム第8回：Windows VM 全自動日本語化】
https://www.intellilink.co.jp/column/ms/2022/020800.aspx
→　弊社の原田さんの記事です。初めはこの記事をベースに日本語化を試行していたのですが、MSサポートブログで 2022年8月から Install-languageコマンドが提供されていたことを知ってから、もっとシンプル化できないか？という思いが生じたためカスタマイズを繰り返して完成形までこぎつけました。システムロケールや地域、言語バーなどの設定はこのサイトを参考にしながらコマンドリファレンスやその他の日本語化のサイトなどを比較検討して組み立てを行っています。

【Windows でのカスタムのスクリプト拡張機能】
https://learn.microsoft.com/ja-jp/azure/virtual-machines/extensions/custom-script-windows#tips
→　このサイトに、カスタムスクリプト内で「再起動を行わないように」との注意書きの記載があり、スクリプトの検討時に参考になりました。

【私の記事：手動で Azure VM の日本語化】
https://qiita.com/carol0226/items/8cc48bb262bf81dfc9df
→　スクリプトではなく、GUI操作で日本語化する場合は、この手順になります。基本的にはこの GUI操作と同じようなことを、本記事ではスクリプトで実装しています。

【AVD ARM 日本語化イメージ作成手順について - Windows 11】
<2024/8/8 追記>
この記事の内容をマージする必要があると思って、記録しています。
https://jpwinsup.github.io/blog/2022/03/02/RemoteDesktopService/AVD/AVD-ARM-Japanese-image-windows11/

検証済みイメージ

Windows 10 Enterprise multi-session, Version-21h2
Windows 10 Enterprise multi-session, Version-21h2 - Gen2
Windows 10 Enterprise multi-session, Version-21h2 + Microsoft 365 Apps
Windows 10 Enterprise multi-session, Version-21h2 + Microsoft 365 Apps - Gen2
Windows 10 Enterprise multi-session, Version-22h2
Windows 10 Enterprise multi-session, Version-22h2 - Gen2
Windows 10 Enterprise multi-session, Version-22h2 + Microsoft 365 Apps
Windows 10 Enterprise multi-session, Version-22h2 + Microsoft 365 Apps - Gen2
Windows 11 Enterprise multi-session, Version-21h2
Windows 11 Enterprise multi-session, Version-21h2 + Microsoft 365 Apps
Windows 11 Enterprise multi-session, Version-22h2
Windows 11 Enterprise multi-session, Version-22h2 + Microsoft 365 Apps

※Windows 10 Pro 20H2 以降であれば仕様上は動作するはず。
　それより古い（2004以前）バージョンは、コマンドの互換性が無くて動作しません。
　Windows Server OS もコマンドの互換性が無くて動作しません。

You get articles that match your needs
You can efficiently read back useful information
You can use dark theme

What you can do with signing up

Azure MarketPlace のイメージから直接デプロイした VM (AVD) を 全自動で日本語化する