Merge pull request #217147 from cebundy/ps-cmds

[Container Apps]: add PowerShell cmdlets to articles

Author: JamesJBarnett

articles/container-apps/communicate-between-microservices.md

@@ -47,10 +47,10 @@ Sign in to the Azure CLI.
 az login
 ```
 
-# [PowerShell](#tab/powershell)
+# [Azure PowerShell](#tab/azure-powershell)
 
-```powershell
-az login
+```azurepowershell
+Connect-AzAccount
 ```
 
 ---
@@ -63,10 +63,10 @@ az login
 az acr login --name $ACR_NAME
 ```
 
-# [PowerShell](#tab/powershell)
+# [Azure PowerShell](#tab/azure-powershell)
 
-```powershell
-az acr login --name $ACR_NAME
+```azurepowershell
+az acr login --name $ACRName
 ```
 
 ---
@@ -110,10 +110,10 @@ az acr login --name $ACR_NAME
 az acr build --registry $ACR_NAME --image albumapp-ui .
 ```
 
-# [PowerShell](#tab/powershell)
+# [Azure PowerShell](#tab/azure-powershell)
 
-```powershell
-az acr build --registry $ACR_NAME --image albumapp-ui .
+```azurepowershell
+az acr build --registry $ACRName --image albumapp-ui .
 ```
 
 ---
@@ -132,10 +132,10 @@ Output from the `az acr build` command shows the upload progress of the source c
     docker build --tag "$ACR_NAME.azurecr.io/albumapp-ui" . 
     ```
 
-    # [PowerShell](#tab/powershell)
+    # [Azure PowerShell](#tab/azure-powershell)
 
-    ```powershell
-    docker build --tag "$ACR_NAME.azurecr.io/albumapp-ui" . 
+    ```azurepowershell
+    docker build --tag "$ACRName.azurecr.io/albumapp-ui" . 
     ```
 
     ---
@@ -150,10 +150,10 @@ Output from the `az acr build` command shows the upload progress of the source c
     az acr login --name $ACR_NAME
     ```
 
-    # [PowerShell](#tab/powershell)
+    # [Azure PowerShell](#tab/azure-powershell)
 
-    ```powershell
-    az acr login --name $ACR_NAME
+    ```azurepowershell
+    az acr login --name $ACRName
     ```
 
     ---
@@ -167,11 +167,11 @@ Output from the `az acr build` command shows the upload progress of the source c
      docker push "$ACR_NAME.azurecr.io/albumapp-ui" 
     ```
 
-    # [PowerShell](#tab/powershell)
+    # [Azure PowerShell](#tab/azure-powershell)
 
-    ```powershell
+    ```azurepowershell
 
-    docker push "$ACR_NAME.azurecr.io/albumapp-ui"
+    docker push "$ACRName.azurecr.io/albumapp-ui"
     ```
 
     ---
@@ -207,10 +207,11 @@ Run the following command to query for the API endpoint address.
 API_BASE_URL=$(az containerapp show --resource-group $RESOURCE_GROUP --name $API_NAME --query properties.configuration.ingress.fqdn -o tsv)
 ```
 
-# [PowerShell](#tab/powershell)
+# [Azure PowerShell](#tab/azure-powershell)
+
+```azurepowershell
+$APIBaseURL = (Get-AzContainerApp -Name $APIName -ResourceGroupName $ResourceGroup).IngressFqdn
 
-```powershell
-$API_BASE_URL=$(az containerapp show --resource-group $RESOURCE_GROUP --name $API_NAME --query properties.configuration.ingress.fqdn -o tsv)
 ```
 
 ---
@@ -232,47 +233,105 @@ az containerapp create \
   --target-port 3000 \
   --env-vars API_BASE_URL=https://$API_BASE_URL \
   --ingress 'external' \
-  --registry-server $ACR_NAME.azurecr.io
+  --registry-server $ACR_NAME.azurecr.io \
+  --query properties.configuration.ingress.fqdn
 ```
 
-# [PowerShell](#tab/powershell)
 
-```azurecli
-az containerapp create `
-  --name $FRONTEND_NAME `
-  --resource-group $RESOURCE_GROUP `
-  --environment $ENVIRONMENT `
-  --image "$ACR_NAME.azurecr.io/albumapp-ui"  `
-  --env-vars API_BASE_URL=https://$API_BASE_URL `
-  --target-port 3000 `
-  --ingress 'external' `
-  --registry-server "$ACR_NAME.azurecr.io"
+By adding the argument `--env-vars "API_BASE_URL=https://$API_ENDPOINT"` to `az containerapp create`, you define an environment variable for your front end application. With this syntax, the environment variable named `API_BASE_URL` is set to the API's FQDN.
+
+The output from the `az containerapp create` command shows the URL of the front end application.
+
+# [Azure PowerShell](#tab/azure-powershell)
+
+To create the container app, create template objects that you'll pass in as arguments to the `New-AzContainerApp` command.
+
+Create a template object to define your container image parameters.  The environment variable named `API_BASE_URL` is set to the API's FQDN.
+
+```azurepowershell
+
+$EnvVars = New-AzContainerAppEnvironmentVarObject -Name API_BASE_URL -Value https://$APIBaseURL
+
+$ContainerArgs = @{
+  Name = $FrontendName
+  Image = $ACRName + '.azurecr.io/albumapp-ui'
+  Env = $EnvVars
+}
+$ContainerObj = New-AzContainerAppTemplateObject @ContainerArgs
 ```
 
----
+You'll need run the following command to get your registry credentials.
 
-By adding the argument `--env-vars "API_BASE_URL=https://$API_ENDPOINT"` to `az containerapp create`, you define an environment variable for your front end application. With this syntax, the environment variable named `API_BASE_URL` is set to the API's FQDN.
+```azurepowershell
+$RegistryCredentials = Get-AzContainerRegistryCredential -Name $ACRName -ResourceGroupName $ResourceGroup
+```
+
+Create a registry credential object to define your registry information, and a secret object to define your registry password.  The `PasswordSecretRef` in `$RegistryObj` refers to the `Name` in `$SecretObj`.  
+
+```azurepowershell
+$RegistryArgs = @{
+    Server = $ACRName + '.azurecr.io'
+    PasswordSecretRef = 'registrysecret'
+    Username = $RegistryCredentials.Username
+}
+$RegistryObj = New-AzContainerAppRegistryCredentialObject @RegistryArgs
+
+$SecretObj = New-AzContainerAppSecretObject -Name 'registrysecret' -Value $RegistryCredentials.Password
+```
+
+Get your environment ID.
+
+```azurepowershell
+$EnvId = (Get-AzContainerAppManagedEnv -EnvName $Environment -ResourceGroup $ResourceGroup).Id
+```
+
+Create the container app.
+
+```azurepowershell
+$AppArgs = @{
+    Name = $FrontendName
+    Location = $Location
+    ResourceGroupName = $ResourceGroup
+    ManagedEnvironmentId = $EnvId
+    TemplateContainer = $ContainerObj
+    ConfigurationRegistry = $RegistryObj
+    ConfigurationSecret = $SecretObj
+    IngressTargetPort = 3000
+    IngressExternal = $true
+}
+$FrontEndApp = New-AzContainerApp @AppArgs
+
+# show the app's FQDN
+
+$FrontEndApp.IngressFqdn
+```
+
+---
 
 ## View website
 
-The `az containerapp create` CLI command returns the fully qualified domain name (FQDN) of your album UI container app. Open this location in a browser to navigate to the web application resembling the following screenshot.
+Use the container app's FQDN to view the website.  The page will resemble the following screenshot.
 
 :::image type="content" source="media/communicate-between-microservices/azure-container-apps-album-ui.png" alt-text="Screenshot of album list UI microservice.":::
 
 ## Clean up resources
 
 If you're not going to continue to use this application, run the following command to delete the resource group along with all the resources created in this quickstart.
 
+> [!CAUTION]
+> This command deletes the specified resource group and all resources contained within it. If resources outside the scope of this tutorial exist in the specified resource group, they will also be deleted.
+
+
 # [Bash](#tab/bash)
 
 ```azurecli
 az group delete --name $RESOURCE_GROUP
 ```
 
-# [PowerShell](#tab/powershell)
+# [Azure PowerShell](#tab/azure-powershell)
 
-```powershell
-az group delete --name $RESOURCE_GROUP
+```azurepowershell
+Remove-AzResourceGroup -Name $ResourceGroup -Force
 ```
 
 ---