Merge pull request #178921 from mikefrobbins/mr-azps-purview-110521

Updated PowerShell content to use Az.Purview

Author: jborsecnik

articles/purview/create-catalog-powershell.md

@@ -3,10 +3,10 @@ title: 'Quickstart: Create a Purview account with PowerShell/Azure CLI'
 description: This Quickstart describes how to create an Azure Purview account using Azure PowerShell/Azure CLI.
 author: hophanms
 ms.author: hophan
-ms.date: 09/27/2021
+ms.date: 10/28/2021
 ms.topic: quickstart
 ms.service: purview
-ms.custom: mode-api
+ms.custom: mode-api, devx-track-azurepowershell
 # Customer intent: As a data steward, I want create a new Azure Purview Account so that I can scan and classify my data.
 ---
 # Quickstart: Create an Azure Purview account using Azure PowerShell/Azure CLI
@@ -28,103 +28,105 @@ For more information about Purview, [see our overview page](overview.md). For mo
 1. Sign in with your Azure credential
 
     # [PowerShell](#tab/azure-powershell)
-    
+
     ```azurepowershell
     Connect-AzAccount
     ```
-    
+
     # [Azure CLI](#tab/azure-cli)
-    
+
     ```azurecli
     az login
     ```
-    
+
     ---
 
 1. If you have multiple Azure subscriptions, select the subscription you want to use:
 
     # [PowerShell](#tab/azure-powershell)
-    
+
     ```azurepowershell
     Set-AzContext [SubscriptionID/SubscriptionName]
     ```
-    
+
     # [Azure CLI](#tab/azure-cli)
-    
+
     ```azurecli
     az account set --subscription [SubscriptionID/SubscriptionName]
     ```
-    
+
     ---
 
 1. Create a resource group for your Purview account. You can skip this step if you already have one:
 
     # [PowerShell](#tab/azure-powershell)
-    
+
     ```azurepowershell
-    New-AzResourceGroup `
-      -Name myResourceGroup `
-      -Location "East US"
+    New-AzResourceGroup -Name myResourceGroup -Location 'East US'
     ```
-    
+
     # [Azure CLI](#tab/azure-cli)
-    
+
     ```azurecli
     az group create \
       --name myResourceGroup \
       --location "East US"
     ```
-    
+
     ---
 
-1. Create a Purview template file such as `purviewtemplate.json`. You can update `name`, `location`, and `capacity` (`4` or `16`):
+1. Create or Deploy the Purview account
 
-    ```json
-    {
-      "$schema": "http://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
-      "contentVersion": "1.0.0.0",
-      "resources": [
-        {
-          "name": "<yourPurviewAccountName>",
-          "type": "Microsoft.Purview/accounts",
-          "apiVersion": "2020-12-01-preview",
-          "location": "EastUs",
-          "identity": {
-            "type": "SystemAssigned"
-          },
-          "properties": {
-            "networkAcls": {
-              "defaultAction": "Allow"
-            }
-          },
-          "dependsOn": [],
-          "sku": {
-            "name": "Standard",
-            "capacity": "4"
-          },
-          "tags": {}
-        }
-      ],
-      "outputs": {}
-    }
-    ```
+    # [PowerShell](#tab/azure-powershell)
 
-1. Deploy Purview template
+    Use the [New-AzPurviewAccount](/powershell/module/az.purview/new-azpurviewaccount) cmdlet to create the Purview account:
 
-    # [PowerShell](#tab/azure-powershell)
-    
     ```azurepowershell
-    New-AzResourceGroupDeployment -ResourceGroupName "<myResourceGroup>" -TemplateFile "<PATH TO purviewtemplate.json>"
+    New-AzPurviewAccount -Name yourPurviewAccountName -ResourceGroupName myResourceGroup -Location eastus -IdentityType SystemAssigned -SkuCapacity 4 -SkuName Standard -PublicNetworkAccess
     ```
-    
+
     # [Azure CLI](#tab/azure-cli)
-    
-    To run this deployment command, you must have the [latest version](/cli/azure/install-azure-cli) of Azure CLI.
-    
-    ```azurecli
-    az deployment group create --resource-group "<myResourceGroup>" --template-file "<PATH TO purviewtemplate.json>"
-    ```
-    
+
+    1. Create a Purview template file such as `purviewtemplate.json`. You can update `name`, `location`, and `capacity` (`4` or `16`):
+
+        ```json
+        {
+          "$schema": "http://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
+          "contentVersion": "1.0.0.0",
+          "resources": [
+            {
+              "name": "<yourPurviewAccountName>",
+              "type": "Microsoft.Purview/accounts",
+              "apiVersion": "2020-12-01-preview",
+              "location": "EastUs",
+              "identity": {
+                "type": "SystemAssigned"
+              },
+              "properties": {
+                "networkAcls": {
+                  "defaultAction": "Allow"
+                }
+              },
+              "dependsOn": [],
+              "sku": {
+                "name": "Standard",
+                "capacity": "4"
+              },
+              "tags": {}
+            }
+          ],
+          "outputs": {}
+        }
+        ```
+
+    1. Deploy Purview template
+
+        To run this deployment command, you must have the [latest version](/cli/azure/install-azure-cli) of Azure CLI.
+
+        ```azurecli
+        az deployment group create --resource-group "<myResourceGroup>" --template-file "<PATH TO purviewtemplate.json>"
+        ```
+
     ---
 
 1. The deployment command returns results. Look for `ProvisioningState` to see whether the deployment succeeded.
@@ -134,7 +136,7 @@ For more information about Purview, [see our overview page](overview.md). For mo
     ```azurecli
     az purview account add-root-collection-admin --account-name --resource-group [--object-id]
     ```
-  
+
     This command will grant the user account [collection admin](catalog-permissions.md#roles) permissions on the root collection in your Azure Purview account. This allows the user to access the Purview Studio and add permission for other users. For more information about permissions in Azure Purview, see our [permissions guide](catalog-permissions.md). For more information about collections, see our [manage collections article](how-to-create-and-manage-collections.md).
 
 ## Next steps