Azure App Service マネージドインスタンス (プレビュー) を構成する

Azure App Service マネージドインスタンス (プレビュー) は、オペレーティングシステム (OS) のカスタマイズ、オプションのプライベートネットワーク、Azure リソースとの安全な統合が必要な Windows Web アプリ向けの、プランをスコープとするホスティングオプションです。この記事では、次の主要な領域でマネージドインスタンスを構成する方法について説明します。

マネージド ID
構成 (インストール) スクリプト
ストレージの取り付け
レジストリキー
リモートデスクトッププロトコル (RDP) アクセス

Important

マネージドインスタンスはプレビュー段階であり、一部のリージョンの Windows Web アプリで使用でき、Pv4 と Pmv4 の価格プランに限定されています。他のリージョンでは今後利用できるようになります。 Linux とコンテナーはサポートされていません。

マネージド ID を追加する (App Service プランに)

プランレベルのマネージド ID を使うと、起動時に Azure Storage にアクセスする構成 (インストール) スクリプト、Key Vault からシークレットをプルするレジストリアダプター、Azure Files への認証を行うストレージマウントなど、プラットフォームレイヤーで発生するインフラストラクチャ操作に対する認証が可能になります。これらのコンポーネントは、プランの複数のアプリが使用する共有リソースです。たとえば、プランレベルの ID を使うとマネージドインスタンスはインフラストラクチャコンポーネントに対する認証を 1 回にすることができ、一方で個々のアプリは、データベースやアプリケーションシークレットなどのアプリ固有のリソースに対して独自の ID を維持します。

次のシナリオでは、App Service プランのマネージド ID が必要です。

Azure Storage に安全にアクセスして、そこから構成スクリプトを取得するため。
ストレージマウントとレジストリキーアダプターの資格情報と値を指定するために Key Vault にアクセスする。

マネージド ID の作成については、ユーザー割り当てマネージド ID の管理に関する記事をご覧ください。

マネージド ID をマネージドインスタンスプランに追加するには:

Azure portal でマネージドインスタンスに移動します。
[ID]>[ユーザー割り当て] を選びます。
[+ 追加] を選択します。
サブスクリプションとマネージド ID を選びます。
[追加] を選んで ID をプランに追加します。

構成 (インストール) スクリプトを追加する

構成 (インストール) スクリプトはインスタンスの起動時に実行され、永続的なカスタマイズを適用します。たとえば、コンポーネントオブジェクトモデル (COM) の登録、Microsoft/Windows インストーラー (MSI) のインストール、インターネットインフォメーションサービス (IIS サーバー) の構成、ACL の変更、Windows の機能の有効化、環境変数の設定などがあります。

構成 (インストール) スクリプトを使うには、次のものが必要です。

App Service プランに割り当てられたマネージド ID
構成 (インストール) スクリプトパッケージ (zip) を保持する BLOB コンテナーのあるストレージアカウント。
ルートに Install.ps1 が含まれる 1 つの ZIP ファイル (エントリポイント)
ストレージアカウント、コンテナー、またはリソースグループに対する Storage Blob Data Reader ロール

構成スクリプトを追加するには:

Azure portal でマネージドインスタンスの App Service プランに移動します。
[構成]>[一般設定] を選びます。

[構成スクリプト] セクションで、まずスクリプトを構成します。

Setting	価値
ストレージアカウント	使うストレージアカウントを選ぶ
コンテナ	コンテナーの名前を入力します
ZIP ファイル	ZIP ファイルの名前を入力します
価値	この値が正しいことを確認します

[適用] を選んで変更を保存します。

構成スクリプトのベストプラクティス

スクリプトをべき等にします (インストールの前に確認します)。
破壊的操作を防ぎます (保護された Windows システムディレクトリを変更しないようにします)。
大きな負荷がかかるインストールを重ならないように調整して、開始時の待ち時間を短縮します。

最小限の zip 構造の例:

Install.ps1
myInstallerfileNameGoesHere.msi
config.xml

構成スクリプトの例:

# Install Components, for example Crystal Reports, Control Library, Database Driver
$ComponentInstaller = "myInstallerFileNameGoesHere.msi"
try {
    $Component = Join-Path $PSScriptRoot $ComponentInstaller
    Start-Process $Component -ArgumentList "/q" -Wait -ErrorAction Stop
} catch {
    Write-Error "Failed to install ${ComponentInstaller}: $_"
    exit 1
}

ストレージマウントを構成する

ストレージマウントは、アプリからアクセスできる永続的な外部ストレージ (Azure Files など) を提供します。シークレット (Key Vault を使います) ではなく、共有ファイルシステムへのアクセスが必要なレガシコードに使います。ローカル (一時) ストレージを使うこともできますが、永続的な変更にはストレージマウントが必要です。

ストレージマウントを構成するには、次のものが必要です。

マネージド ID (Key Vault アクセス用)
Key Vault シークレット (資格情報ソース)

ストレージマウントを構成するには:

Azure portal でマネージドインスタンスに移動します。
[構成]>[マウント] を選びます。
[+ 新しいストレージマウント] を選びます。

次の詳細を指定して、ストレージマウントを構成します。

Setting	価値
名前	マウント名を入力します
ストレージの種類	Azure Files、カスタム、またはローカル (一時ストレージ)
ストレージアカウント	ストレージアカウントを選択または入力します
ファイル共有	ファイル共有を選択します
価値	キーコンテナーを選択します
Secret	キーコンテナーシークレットを選択します
ドライブ文字をマウントする	ドライブ文字のパスを選択します

外部ストレージをマネージドインスタンスにマウントできます。マウントされたストレージは再起動後も永続的であり、アプリのファイルシステムからアクセスできます。

Azure Files を使用してストレージマウントを構成する

Azure Files のストレージマウントを構成するには:

Azure ストレージアカウントと Azure Files 共有を作成します。
接続資格情報をシークレットとして Key Vault に格納します。サポートされているシークレットの内容: (例: DefaultEndpointsProtocol=...;AccountName=...;AccountKey=...;EndpointSuffix=core.windows.net)
マウントをマネージドインスタンスに追加します (Azure portal または ARM/Bicep/Terraform)。

ヒント

セキュリティを強化するために、Azure RBAC と共有 ACL を使って共有レベルのアクセス許可を適用します。

カスタム UNC を使用してストレージマウントを構成する

他の場所 (オンプレミス、VM、または Microsoft 以外) でホストされている SMB 共有へのマウントを使います。ネットワークに確実に接続します (仮想ネットワーク統合、プライベートエンドポイント、ファイアウォール)。

資格情報が必要な場合は、次の形式で Key Vault シークレットにそれを格納します: username=<user>,password=<password>
- ドメイン管理者アカウントは使わず、最小限の特権を持つサービス ID を使います。
マウントをマネージドインスタンスに追加します。

レジストリキーを構成する

アプリケーションの中には、Windows レジストリから読み取られた値に依存するものがあります。レジストリキーアダプターを使うと、レジストリキーを作成し、Azure Key Vault のシークレットを値として使用できます。

レジストリキーを構成するには、次のものが必要です。

マネージド ID (Key Vault アクセス用)
Key Vault シークレット (資格情報ソース)

レジストリキーを構成するには:

[構成]>[レジストリキー] に移動します。

[+ 追加] を選択します。

Setting	価値
経路	レジストリパスを入力します
Vault	既存のコンテナー名を入力します
Secret	キーコンテナーシークレットを選択または入力します
タイプ	文字列または DWORD

[追加] を選んでレジストリキーを追加します。

注意事項

システムにとって重要なレジストリパスを変更するときは注意してください。誤って変更すると、インスタンスの安定性に影響する可能性があります。

RDP (Bastion) アクセスを構成する

クイックスタート: Azure Bastion を自動的にデプロイすると、リモートデスクトッププロトコル (RDP) を使用して VM インスタンスに安全に接続できます。 Azure Bastion 経由の RDP は、一時的な診断 (ログの検査、迅速な検証) 用です。ポータルから Bastion を使う場合は、Bastion リソースを Standard 価格レベルにアップグレードして、[ネイティブクライアントサポートと IP ベースの接続] を選びます。

Bastion と RDP のアクセスには、次のリソースが必要です。

マネージドインスタンスは仮想ネットワークに統合されている必要があります
ターゲット仮想ネットワーク上の Azure Bastion ホスト
Bastion サブネットの NSG から App Service プランサブネットの NSG へのポート 3389 を許可する必要があります

Bastion を構成するには:

[構成]>[Bastion/RDP] に移動します。
仮想ネットワークが接続されていることを確認します。
[リモートデスクトップを許可する (Bastion 経由)] を選びます。

注意事項

RDP 経由のみで、手動インストーラーや構成の変更を適用しないでください。リサイクル時または構成ドリフトの作成時に変更が失われます。

よく寄せられる質問 (FAQ)

Azure App Service マネージドインスタンスで実行されているオペレーティングシステム (OS) は何ですか?
その他の Windows の役割と機能を有効にすることはできますか?
Azure App Service マネージドインスタンスは、プラットフォームとアプリケーションの定期的なスタック更新プログラムを受け取りますか?
Azure App Service マネージドインスタンスにインストールされているプログラミング言語は何ですか?
構成 (インストール) スクリプトにはどのような制限がありますか?
構成 (インストール) スクリプトはどのアクセス許可レベルで実行されますか?
Bastion を使用してインスタンスに接続するとき、オペレーターはどのようなロールのアクセス許可を持っていますか?
構成 (インストール) スクリプトまたはレジストリやストレージアダプターでのエラーのトラブルシューティングを行うにはどうすればよいですか?
Azure App Service マネージドインスタンスのワーカーインスタンスのアドレス指定可能なメモリは何ですか?
構成 (インストール) スクリプトをアップロードするには、どの Azure Storage サービスを使用する必要がありますか?
構成 (インストール) スクリプトの名前付けと形式に制限はありますか?
ZIP ファイルの一部としてアップロードできる依存関係のサイズに制限はありますか?
App Service プランのアダプターでマネージドインスタンスを追加または編集すると、プランのインスタンスが再起動されますか?
マネージドインスタンスのプランに複数のインスタンスがある場合、1 つのインスタンスを再起動できますか?
App Service プランのマネージドインスタンスに複数の Web アプリケーションがある場合、1 つの Web アプリケーションを再起動できますか?
App Service プランのマネージドインスタンス内の Web アプリケーションにマネージド ID を割り当てることができますか?
App Service プランのマネージドインスタンスに作成できるアダプターの数に制限はありますか?

Azure App Service マネージドインスタンスで実行されているオペレーティングシステム (OS) は何ですか?

Windows Server 2022。

その他の Windows の役割と機能を有効にすることはできますか?

はい。構成スクリプトを使用します。ただし、Windows Server の今後のリリースから削除された機能は、マネージドインスタンスでは使用できません。

Azure App Service マネージドインスタンスは、プラットフォームとアプリケーションの定期的なスタック更新プログラムを受け取りますか?

はい。インスタンスは、定期的なプラットフォームの更新プログラムとメンテナンスを受け取ります。プレインストールされているアプリケーションスタックも定期的に更新されます。構成 (インストール) スクリプトを介してインストールされたコンポーネントは、ユーザーが維持する必要があります。

Azure App Service マネージドインスタンスにインストールされているプログラミング言語は何ですか?

Microsoft .NET Framework 3.5 と 4.8、および Microsoft .NET 8.0 です。他のランタイムが必要な場合は、構成スクリプトを使ってインストールできます。これらはプラットフォームによって管理されないため、手動で更新する必要があります。

構成 (インストール) スクリプトにはどのような制限がありますか?

構成 (インストール) スクリプトを使うと、依存関係のインストール、役割と機能の有効化、オペレーティングシステムのカスタマイズを行うことができます。ただし、破壊的操作 (Windows\System32 の削除など) はサポートされておらず、インスタンスが不安定になる可能性があります。

構成 (インストール) スクリプトはどのアクセス許可レベルで実行されますか?

システムレベルのコンポーネントをインストールして構成できるよう、構成 (インストール) スクリプトは管理者のアクセス許可で実行されます。

Bastion を使用してインスタンスに接続するとき、オペレーターはどのようなロールのアクセス許可を持っていますか?

Bastion 経由で接続するオペレーターは、セッション中に管理者特権を使用します。

構成 (インストール) スクリプトまたはレジストリやストレージアダプターでのエラーのトラブルシューティングを行うにはどうすればよいですか?

トラブルシューティングを行うには、構成 (インストール) スクリプトのログを確認します。これらは、(Web アプリではなく) インスタンス上の C:\InstallScripts\Script\Install.log にあります。または、App Service コンソールのログを Azure Monitor と Log Analytics に配布することもできます。

アダプターログは、マシンのルートで見つかります。または、App Service のプラットフォームログにログされます。

Azure App Service マネージドインスタンスのワーカーインスタンスのアドレス指定可能なメモリは何ですか?

Azure App Service マネージドインスタンスのワーカーインスタンスのアドレス指定可能なメモリは、選んだ価格プランによって異なります。次の表は、Azure App Service マネージドインスタンスのワーカーインスタンスでアドレス指定可能なメモリの一覧です。他のコンポーネントやサービスなどをインストールする構成スクリプトがあるかどうかを検討することが重要です。これらのリソースは、Web アプリで使用できるメモリの量に影響します。

料金プラン	コア	メモリ (MB)
P0v4	1	2048
P1v4	2	5952
P2v4	4	13440
P3v4	八	28672
P1Mv4	2	13440
P2Mv4	4	28672
P3Mv4	八	60160
P4Mv4	16	121088
P5Mv4	32	246016

構成 (インストール) スクリプトをアップロードするには、どの Azure Storage サービスを使用する必要がありますか?

スクリプトと必要な依存関係のアップロードには Azure Storage Blob サービスを使います。

構成 (インストール) スクリプトの名前付けと形式に制限はありますか?

はい。スクリプトの名前は Install.ps1 にする必要があります。 PowerShell のみがサポートされています。構成 (インストール) スクリプトと依存関係を 1 つの .zip ファイルとしてアップロードしてください。

ZIP ファイルの一部としてアップロードできる依存関係のサイズに制限はありますか?

サイズ制限は適用されません。依存関係の全体的なサイズは、インスタンスのプロビジョニング時間に影響することに注意してください。

App Service プランのアダプターでマネージドインスタンスを追加または編集すると、プランのインスタンスが再起動されますか?

はい。マネージドインスタンスのプランのアダプター (構成スクリプト、ストレージ、レジストリ) を追加または編集すると、基になるインスタンスが再起動され、プランにデプロイされているすべての Web アプリに影響します。インスタンスが再起動すると、RDP セッションで行われたすべての変更が削除されることにご注意ください。依存関係のインストールまたは必要な他の構成変更を保持するには、常に構成 (インストール) スクリプトをお使いください。

マネージドインスタンスのプランに複数のインスタンスがある場合、1 つのインスタンスを再起動できますか?

はい。マネージドインスタンスを参照し、左側のメニューで [インスタンス] を選びます。次に、インスタンス名の横にある [再起動] を選びます。

App Service プランのマネージドインスタンスに複数の Web アプリケーションがある場合、1 つの Web アプリケーションを再起動できますか?

はい。アプリの [概要] ページに移動して、[再起動] を選びます。

App Service プランのマネージドインスタンス内の Web アプリケーションにマネージド ID を割り当てることができますか?

はい。マネージドインスタンス内の Web アプリケーションに "異なる" マネージド ID を割り当てることができます。マネージド ID のガイダンスに関する記事に従ってください

App Service プランのマネージドインスタンスに作成できるアダプターの数に制限はありますか?

いいえ。ストレージまたはレジストリのアダプターの数に制限はありません。 App Service プランのマネージドインスタンスでは、構成 (インストール) スクリプトアダプターを 1 つだけ作成できます。アダプターの数を増やすと、マネージドインスタンスのプロビジョニング時間に影響する可能性があります。

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-11-20

次の方法で共有

Azure App Service マネージド インスタンス (プレビュー) を構成する

マネージド ID を追加する (App Service プランに)

構成 (インストール) スクリプトを追加する

構成スクリプトのベスト プラクティス

ストレージ マウントを構成する

Azure Files を使用してストレージ マウントを構成する

カスタム UNC を使用してストレージ マウントを構成する

レジストリ キーを構成する

RDP (Bastion) アクセスを構成する

よく寄せられる質問 (FAQ)

Azure App Service マネージド インスタンスで実行されているオペレーティング システム (OS) は何ですか?

その他の Windows の役割と機能を有効にすることはできますか?

Azure App Service マネージド インスタンスは、プラットフォームとアプリケーションの定期的なスタック更新プログラムを受け取りますか?

Azure App Service マネージド インスタンスにインストールされているプログラミング言語は何ですか?