Webアプリの複製時に「The parameter WindowsFxVersion has an invalid value.」と表示され失敗してしまう

Question

Webアプリの複製時に「The parameter WindowsFxVersion has an invalid value.」と表示され失敗してしまう

栗原佑太 10

webアプリ（Windowsコンテナ）を複製しようすると、以下のようなエラーが表示され失敗します。

「The parameter WindowsFxVersion has an invalid value.」

対象のwebアプリではマネージドIDを有効化しており、Azure Container Registryへのアクセス権限は確認しております。

解決策をご存じの方がいらっしゃればご教示いただけますと幸いです。

Shree Hima Bindu Maganti 4,615 評価のポイント Microsoft 外部スタッフ Moderator

2025-04-30T11:09:42.1866667+00:00
Hi @栗原佑太 • フォロー
The error message "The parameter WindowsFxVersion has an invalid value" usually means that the specified WindowsFxVersion is either unrecognized or incorrectly formatted.

Ensure that the WindowsFxVersion value you are using is valid and corresponds to a supported version of the Windows container. Refer to the Azure documentation for the correct format and available versions.

Since the managed identity is enabled and access permissions to Azure Container Registry are confirmed, make sure the identity has the necessary roles (like AcrPull) to pull the container image.

Verify that the container image you are trying to use is available in the Azure Container Registry and that the specified tag is correct.

If the issue persists, try recreating the web app with the correct parameters instead of duplicating it.
https://learn.microsoft.com/en-us/answers/questions/1410857/deploying-container-to-web-app-returns-windowsfxve
Migrate custom software to Azure App Service using a custom container (container-windows)Use managed identity to pull image from Azure Container Registry
Let mi know if you have any further assistances.
Siva Nair 2,095 評価のポイント Microsoft 外部スタッフ Moderator

2025-05-02T05:04:08.5366667+00:00

Hi 栗原佑太,

洞察を提供していただきありがとうございます、あなたはそれの完全な原因を理解するために全体のエラーメッセージのスクリーンショットを送信してください。App Service Windowsを使用していて、Linuxイメージを実行しようとしていますか?

「AzureポータルとARMテンプレートで同じエラーが発生します」とおっしゃったように、ARMテンプレートまたはBicep / YAMLファイルの関連部分、特に定義されているセクションを共有していただけます siteConfig windowsFxVersion か?これにより、構成の潜在的な問題を特定できます。

感謝！
Siva Nair 2,095 評価のポイント Microsoft 外部スタッフ Moderator

2025-05-02T07:02:35.4333333+00:00
Hi 栗原佑太,

Thanks for sharing error code and that you're using a Windows-based container for your Windows App Service.

WindowsFxVersion is used to define the container image in App Service. For Windows containers, it must be set correctly in the App Service configuration.

Go to your App Service in the Azure Portal.

Navigate to Configuration > General settings.

Under Stack settings, ensure:

Platform is set to Windows.

Startup File is empty (unless your container requires a specific entry point).

Under Configuration > Application settings, ensure:

WEBSITES_ENABLE_APP_SERVICE_STORAGE is set to false.

DOCKER_CUSTOM_IMAGE_NAME is set to: redxposstandardtestbase.azurecr.io/devops-pos4ulogicservice-loft:6599

DOCKER_REGISTRY_SERVER_URL is: https://redxposstandardtestbase.azurecr.io

You need to ensure your App Service can authenticate with your Azure Container Registry (ACR).

Option A: Use Managed Identity

In your App Service, go to Identity > System assigned and turn it On.

Go to your ACR → Access control (IAM) → Add role assignment:

Role: AcrPull

Assign access to: Managed identity

Select your App Service

Option B: Use Admin Credentials

In ACR → Access keys, enable Admin user.

In App Service → Configuration > Application settings, add:

DOCKER_REGISTRY_SERVER_USERNAME: your ACR admin username

DOCKER_REGISTRY_SERVER_PASSWORD: your ACR admin password

If you have any further assistant, do let me know if you are still facing the same error
Harshitha Veeramalla 1,146 評価のポイント Microsoft 外部スタッフ Moderator

2025-05-05T12:03:32.5566667+00:00

Hi @栗原佑太,

上記の情報が役に立ったかどうか確認しています。この問題についてさらに更新があれば、遠慮なくお知らせください。
Bodapati Harish 795 評価のポイント Microsoft 外部スタッフ Moderator

2025-05-06T13:01:03.68+00:00
Hi @栗原佑太,

まず、App Service が ACR（Azure Container Registry）に接続できるように、ACR のネットワーク設定を確認します。Azure ポータルで以下の操作を行ってください：

Azure ポータル → App Services → [対象の App Service 名] に移動します。概要ページで Outbound IP Addresses（送信 IP アドレス） を探して、それらをメモしてください。

次に、Azure ポータル → Container Registries → [対象の ACR 名] に移動し、ネットワーク または ファイアウォール 設定を確認します。ファイアウォールが有効になっている場合、App Service からのアクセスがブロックされている可能性があります。先ほどメモした送信 IP が許可されているかを確認してください。

続いて、イメージがアクセス可能かを確認します。Azure CLI を使って以下のコマンドを実行します：

az acr login --name redxposstandardtestbase

次に、以下のコマンドでイメージを pull できるかを確認します：

docker pull redxposstandardtestbase.azurecr.io/devops-pos4ulogicservice-loft:6599

また、イメージタグが存在するかを以下のコマンドで確認できます：

az acr repository show-tags --name redxposstandardtestbase --repository devops-pos4ulogicservice-loft

マネージド ID を使用している場合、権限が有効になるまで数分かかることがあります。App Service のマネージド ID に AcrPull ロールが割り当てられているかを確認してください。確認手順は以下の通りです：

Azure ポータル → Container Registries → [対象の ACR 名] → アクセス制御 (IAM) に移動して、AcrPull ロールが App Service に正しく割り当てられているか確認します。割り当てられていれば、数分待ってから再試行してください。

また、使用しているイメージが Azure App Service でサポートされている Windows ベースのイメージであることを確認してください。たとえば、mcr.microsoft.com/windows/servercore や nanoserver などが推奨されます。Azure は特定のベースイメージしかサポートしていません。

上記の手順で問題が解決しない場合は、複製プロセスに問題がある可能性があります。代わりに、新しい App Service を同じ設定で作成してみてください。現在の App Service から設定テンプレートをエクスポートし、それを使って新しいサービスを作成することができます。手動でファイルをコピーする方法もありますが、なるべく簡単な方法を試しましょう。

CLI コマンドの実行結果などがあれば、それを共有してください。引き続きサポートいたします。

1 件の回答

お客様の回答

Shree Hima Bindu Maganti 4,615 評価のポイント Microsoft 外部スタッフ Moderator

2025-04-30T11:09:42.1866667+00:00

Hi @栗原佑太 • フォロー
The error message "The parameter WindowsFxVersion has an invalid value" usually means that the specified WindowsFxVersion is either unrecognized or incorrectly formatted.

Ensure that the WindowsFxVersion value you are using is valid and corresponds to a supported version of the Windows container. Refer to the Azure documentation for the correct format and available versions.

Since the managed identity is enabled and access permissions to Azure Container Registry are confirmed, make sure the identity has the necessary roles (like AcrPull) to pull the container image.

Verify that the container image you are trying to use is available in the Azure Container Registry and that the specified tag is correct.

If the issue persists, try recreating the web app with the correct parameters instead of duplicating it.
https://learn.microsoft.com/en-us/answers/questions/1410857/deploying-container-to-web-app-returns-windowsfxve
Migrate custom software to Azure App Service using a custom container (container-windows)Use managed identity to pull image from Azure Container Registry
Let mi know if you have any further assistances.
Siva Nair 2,095 評価のポイント Microsoft 外部スタッフ Moderator

2025-05-02T05:04:08.5366667+00:00

Hi 栗原佑太,

洞察を提供していただきありがとうございます、あなたはそれの完全な原因を理解するために全体のエラーメッセージのスクリーンショットを送信してください。App Service Windowsを使用していて、Linuxイメージを実行しようとしていますか?

「AzureポータルとARMテンプレートで同じエラーが発生します」とおっしゃったように、ARMテンプレートまたはBicep / YAMLファイルの関連部分、特に定義されているセクションを共有していただけます siteConfig windowsFxVersion か?これにより、構成の潜在的な問題を特定できます。

感謝！
Siva Nair 2,095 評価のポイント Microsoft 外部スタッフ Moderator

2025-05-02T07:02:35.4333333+00:00

Hi 栗原佑太,

Thanks for sharing error code and that you're using a Windows-based container for your Windows App Service.

WindowsFxVersion is used to define the container image in App Service. For Windows containers, it must be set correctly in the App Service configuration.

Go to your App Service in the Azure Portal.

Navigate to Configuration > General settings.

Under Stack settings, ensure:

Platform is set to Windows.

Startup File is empty (unless your container requires a specific entry point).

Under Configuration > Application settings, ensure:

WEBSITES_ENABLE_APP_SERVICE_STORAGE is set to false.

DOCKER_CUSTOM_IMAGE_NAME is set to: redxposstandardtestbase.azurecr.io/devops-pos4ulogicservice-loft:6599

DOCKER_REGISTRY_SERVER_URL is: https://redxposstandardtestbase.azurecr.io

You need to ensure your App Service can authenticate with your Azure Container Registry (ACR).

Option A: Use Managed Identity

In your App Service, go to Identity > System assigned and turn it On.

Go to your ACR → Access control (IAM) → Add role assignment:

Role: AcrPull

Assign access to: Managed identity

Select your App Service

Option B: Use Admin Credentials

In ACR → Access keys, enable Admin user.

In App Service → Configuration > Application settings, add:

DOCKER_REGISTRY_SERVER_USERNAME: your ACR admin username

DOCKER_REGISTRY_SERVER_PASSWORD: your ACR admin password

If you have any further assistant, do let me know if you are still facing the same error
Harshitha Veeramalla 1,146 評価のポイント Microsoft 外部スタッフ Moderator

2025-05-05T12:03:32.5566667+00:00

Hi @栗原佑太,

上記の情報が役に立ったかどうか確認しています。この問題についてさらに更新があれば、遠慮なくお知らせください。

Answer 1

Hi @栗原佑太,

この問題は、Azure Container Registry (ACR) から Azure Web アプリに Windows コンテナーイメージをプルしようとしたときに、無効または承認されていない構成が原因で発生しました。 WindowsFxVersion 正しく設定されていても、認証やネットワークの制限によりイメージをプルできませんでした。

解決手順:

、DOCKER_CUSTOM_IMAGE_NAME、および関連する環境変数が正しく設定DOCKER_REGISTRY_SERVER_URLされていることを確認。
コンテナイメージタグが存在し、Azure CLIを使用して手動でプルできることを確認しました。
Web アプリでシステム割り当てマネージド ID が有効になっており、ACR で ID に AcrPull アクセス許可が付与されていることを確認します。
App Service の送信 IP** を確認し ** 、ACR ファイアウォールの許可リストに追加しました。
イメージが Azure App Service でサポートされている** Windows 基本イメージ**を使用してビルドされたことを確認しました。

上記のすべてが確認されると、デプロイは正常に機能しました。または、問題が解決しない場合は、クローンを作成するのではなく、同じ構成で新しい App Service を手動で作成すると、問題が回避される可能性があります。

お役に立てれば幸いです。

「回答を受け入れる**」**をクリックすることを忘れないでくださいYes、そして提供された情報があなたを助けるところならどこでも、これは他のコミュニティメンバーにとって有益です。

Sampath 3,660 評価のポイント Microsoft 外部スタッフ Moderator

2025-05-14T11:53:49.78+00:00

Hi @栗原佑太, ご提供した回答が参考になったかどうか、ご確認させていただきます。もしお役に立てたようであれば、「回答を承認する」をクリックし、「はい」を選択してください。他のコミュニティメンバーにも参考になります。ご不明な点がございましたら、お気軽にお知らせください。

次の方法で共有

Webアプリの複製時に「The parameter WindowsFxVersion has an invalid value.」と表示され失敗してしまう

1 件の回答

お客様の回答