Merge pull request #277152 from v-jaswel/aca/v-jaswel_work_item_252526_cli_steps_20240506.txt

[ACA] Update install instructions

Author: prmerger-automator[bot]

articles/container-apps/troubleshooting.md

@@ -27,6 +27,8 @@ The following table lists issues you might encounter while using Azure Container
 | Requests to endpoints fail | The container app endpoint doesn't respond to requests. | [Review ingress configuration](#review-ingress-configuration) |
 | Requests return status 403 | The container app endpoint responds to requests with HTTP error 403 (access denied). |  [Verify networking configuration is correct](#verify-networking-configuration) |
 | Responses not as expected | The container app endpoint responds to requests, but the responses aren't as expected. | [Verify traffic is routed to the correct revision](#verify-traffic-is-routed-to-the-correct-revision)<br><br>[Verify you're using unique tags when deploying images to the container registry](/azure/container-registry/container-registry-image-tag-version) |
+| Missing parameters error | You receive error messages about missing parameters when you run `az containerapp` commands in the Azure CLI, or run cmdlets from the `Az.App` module in Azure PowerShell. | [Verify latest version of Azure Container Apps extension is installed](#verify-latest-version-of-azure-container-apps-extension-is-installed) |
+| Preview features not available | [Preview features](./whats-new.md) are not available when you run `az containerapp` commands in the Azure CLI. | [Verify Azure Container Apps extension allows preview features](#verify-azure-container-apps-extension-allows-preview-features) |
 
 ## View logs
 
@@ -178,6 +180,38 @@ If **Revision Mode** is set to `Multiple`, verify you're not routing traffic to
 
 For more information about configuring traffic splitting, see [Traffic splitting in Azure Container Apps](./traffic-splitting.md).
 
+## Verify latest version of Azure Container Apps extension is installed
+
+If you receive errors about missing parameters when you run `az containerapp` commands in Azure CLI or cmdlets from the `Az.App` module in Azure PowerShell, be sure you have the latest version of the Azure Container Apps extension installed.
+
+# [Bash](#tab/bash)
+
+```azurecli
+az extension add --name containerapp --upgrade
+```
+
+# [Azure PowerShell](#tab/azure-powershell)
+
+```azurepowershell
+Install-Module -Name Az.App
+```
+
+If you have an older version of the `Az.App` module installed, update it.
+
+```azurepowershell
+Update-Module -Name Az.App
+```
+
+---
+
+## Verify Azure Container Apps extension allows preview features
+
+If [preview features](./whats-new.md) are not available when you run `az containerapp` commands in the Azure CLI, enable preview features on the Azure Container Apps extension.
+
+```azurecli
+az extension add --name containerapp --upgrade --allow-preview true
+```
+
 ## Next steps
 
 > [!div class="nextstepaction"]

includes/container-apps-create-cli-steps.md

@@ -44,19 +44,27 @@ Ignore any warnings about modules currently in use.
 
 Next, install or update the Azure Container Apps extension for the CLI.
 
+If you receive errors about missing parameters when you run `az containerapp` commands in Azure CLI or cmdlets from the `Az.App` module in Azure PowerShell, be sure you have the latest version of the Azure Container Apps extension installed.
+
 # [Bash](#tab/bash)
 
 ```azurecli
 az extension add --name containerapp --upgrade
 ```
 
+> [!NOTE]
+> Starting in May 2024, Azure CLI extensions no longer enable preview features by default. To access Container Apps [preview features](../articles/container-apps/whats-new.md), install the Container Apps extension with `--allow-preview true`.
+> ```azurecli
+> az extension add --name containerapp --upgrade --allow-preview true
+> ```
+
 # [Azure PowerShell](#tab/azure-powershell)
 
 ```azurepowershell
 Install-Module -Name Az.App
 ```
 
-If you have an older version of the Az.App module installed, update it.
+Make sure to update the `Az.App` module to the latest version.
 
 ```azurepowershell
 Update-Module -Name Az.App