Merge pull request #224461 from halkazwini/ps-cli2

Peering Service: Freshness: Register a Peering Service connection by using the Azure CLI

Author: v-regandowner

articles/peering-service/cli.md

@@ -1,93 +1,115 @@
 ---
-title: Register a Peering Service Preview connection by using the Azure CLI 
-description: Learn how to register a Peering Service connection by using the Azure CLI
+title: Create, change, or delete a Peering Service connection - Azure CLI 
+description: Learn how to create, change, or delete a Peering Service connection using the Azure CLI
 services: peering-service
 author: halkazwini
 ms.service: peering-service
 ms.topic: how-to
-ms.tgt_pltfrm: na
 ms.workload: Infrastructure-services
-ms.date: 05/2/2020
+ms.date: 01/19/2023
 ms.author: halkazwini
+ms.custom: template-how-to, engagement-fy23
 ---
 
-# Register a Peering Service connection by using the Azure CLI
+# Create, change, or delete a Peering Service connection using the Azure CLI
 
-Azure Peering Service is a networking service that enhances customer connectivity to Microsoft cloud services such as Microsoft 365, Dynamics 365, software as a service (SaaS) services, Azure, or any Microsoft services accessible via the public internet. In this article, you'll learn how to register a Peering Service connection by using the Azure CLI.
+> [!div class="op_single_selector"]
+> * [Portal](azure-portal.md)
+> * [PowerShell](powershell.md)
+> * [Azure CLI](cli.md)
 
-- This article requires version 2.0.28 or later of the Azure CLI. Run [az version](/cli/azure/reference-index#az-version) to find the version and dependent libraries that are installed. To upgrade to the latest version, run [az upgrade](/cli/azure/reference-index#az-upgrade).
+Azure Peering Service is a networking service that enhances customer connectivity to Microsoft cloud services such as Microsoft 365, Dynamics 365, software as a service (SaaS) services, Azure, or any Microsoft services accessible via the public internet.
+
+In this article, you'll learn how to create, change, and delete a Peering Service connection using the Azure CLI.
+
+If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
+
+[!INCLUDE [azure-cli-prepare-your-environment-h3.md](~/articles/reusable-content/azure-cli/azure-cli-prepare-your-environment-no-header.md)]
+
+If you decide to install and use Azure CLI locally, this article requires you to use version 2.0.28 or later of the Azure CLI. Run [az version](/cli/azure/reference-index#az-version) to find the version and dependent libraries that are installed. To upgrade to the latest version, run [az upgrade](/cli/azure/reference-index#az-upgrade). If using Azure Cloud Shell, the latest version is already installed.
 
 ## Prerequisites 
 
-You must have the following:
+- An Azure subscription.
+
+- A connectivity provider. For more information, see [Peering Service partners](./location-partners.md).
 
-### Azure account
+## Register your subscription with the resource provider and feature flag
 
-You must have a valid and active Microsoft Azure account. This account is required to set up the Peering Service connection. Peering Service is a resource within Azure subscriptions.
+Before you proceed to the steps of creating the Peering Service connection, register your subscription with the resource provider and feature flag using [az feature register](/cli/azure/feature.md#az-feature-register) and [az provider register](/cli/azure/provider.md#az-provider-register):
+
+```azurecli-interactive
+az feature register --namespace Microsoft.Peering --name AllowPeeringService
+az provider register --name Microsoft.Peering
+```
 
-### Connectivity provider
+## List Peering Service locations and service providers 
 
-You can work with an internet service provider or internet exchange partner to obtain Peering Service to connect your network with the Microsoft network.
+Use [az peering service country list](/cli/azure/peering/service/country.md#az-peering-service-country-list) to list the countries where Peering Service is available and [az peering service location list](/cli/azure/peering/service/location.md#az-peering-service-location-list) to list the available metro locations in a specific country where you can get the Peering Service:
 
-Make sure that the connectivity providers are partnered with Microsoft.
+```azurecli-interactive
+# List the countries available for Peering Service.
+az peering service country list --out table
+# List metro locations serviced in a country
+az peering service location list --country "united states" --output table
+```
 
-[!INCLUDE [azure-cli-prepare-your-environment-h3.md](~/articles/reusable-content/azure-cli/azure-cli-prepare-your-environment-h3.md)]
+Use [az peering service provider list](/cli/azure/peering/service/provider.md#az-peering-service-provider-list) to get a list of available [Peering Service providers](location-partners.md):
 
-- This article requires version 2.0.28 or later of the Azure CLI. If using Azure Cloud Shell, the latest version is already installed.
+```azurecli-interactive
+az peering service provider list --output table
+```
 
-### 1. Select your subscription
+## Create a Peering Service connection
 
-Select the subscription for which you want to register the Peering Service connection.
+Create a Peering Service connection using [az peering service create](/cli/azure/peering/service.md#az-peering-service-create):
 
 ```azurecli-interactive
-az account set --subscription "<subscription ID>"
+az peering service create --location "eastus" --peering-service-name "myPeeringService" --resource-group "myResourceGroup" --peering-service-location "Virginia" --peering-service-provider "Contoso"
 ```
 
-If you don't already have a resource group, you must create one before you register your Peering Service connection. You can create a resource group by running the following command:
+## Add the Peering Service prefix
+
+Use [az peering service prefix create](/cli/azure/peering/service/prefix.md#az-peering-service-prefix-create) to add the prefix provided to you by the connectivity provider:
 
 ```azurecli-interactive
-az group create -n MyResourceGroup -l "West US"
+az peering service prefix create --peering-service-name "myPeeringService" --prefix-name "myPrefix" --resource-group "myResourceGroup" --peering-service-prefix-key "00000000-0000-0000-0000-000000000000" --prefix "240.0.0.0/32"
 ```
 
-### 2. Register your subscription with the resource provider and feature flag
+## List all Peering Services connections
 
-Before you proceed to the steps of registering the Peering Service connection by using the Azure CLI, register your subscription with the resource provider and feature flag by using the Azure CLI. The Azure CLI commands are specified here:
+To view the list of all Peering Service connections, use [az peering service list](/cli/azure/peering/service.md#az-peering-service-list):
 
 ```azurecli-interactive
+az peering service list --resource-group "myresourcegroup" --output "table"
+```
 
-az feature register --namespace Microsoft.Peering --name AllowPeeringService
+## List all Peering Service prefixes
 
+To view the list of all Peering Service prefixes, use [az peering service prefix list](/cli/azure/peering/service/prefix.md#az-peering-service-prefix-list):
+
+```azurecli-interactive
+az peering service prefix list --peering-service-name "myPeeringService" --resource-group "myResourceGroup"
 ```
 
-### 3. Register the Peering Service connection
+## Remove the Peering Service prefix
 
-Register the Peering Service connection by using the following set of commands via the Azure CLI. This example registers the Peering Service connection named myPeeringService.
+To remove a Peering Service prefix, use [az peering service prefix delete](/cli/azure/peering/service/prefix.md#az-peering-service-prefix-delete):
 
 ```azurecli-interactive
-az peering service create : Create peering service\
-  --location -l \
-  --name myPeeringService\
-  --resource-group -g MyResourceGroup\
-  --peering-service-location\
-  --peering-service-provider\
-  --tags
+az peering service prefix delete --peering-service-name "myPeeringService" --prefix-name "myPrefix" --resource-group "myResourceGroup"
 ```
 
-### 4. Register the prefix
+## Delete a Peering Service connection
 
-Register the prefix that's provided by the connectivity provider by executing the following commands via the Azure CLI. This example registers the prefix named myPrefix.
+To delete a Peering Service connection, use [az peering service delete](/cli/azure/peering/service.md#az-peering-service-delete):
 
 ```azurecli-interactive
-az peering service prefix create \
-  --name  myPrefix\
-  --peering-service-name myPeeringService\
-  --resource-group  -g myResourceGroup\
+az peering service delete --peering-service-name "myPeeringService" --resource-group "myResourceGroup"
 ```
 
 ## Next steps
 
 - To learn more about Peering Service connection, see [Peering Service connection](connection.md).
-- To learn about Peering Service connection telemetry, see [Peering Service connection telemetry](connection-telemetry.md).
-- To measure telemetry, see [Measure connection telemetry](measure-connection-telemetry.md).
-- To register the connection by using Azure PowerShell, see [Register a Peering Service connection - Azure PowerShell](powershell.md).
-- To register the connection by using the Azure portal, see [Register a Peering Service connection - Azure portal](azure-portal.md).
+- To learn more about Peering Service connection telemetry, see [Peering Service connection telemetry](connection-telemetry.md).
+- To measure Peering Service connection telemetry, see [Measure connection telemetry](measure-connection-telemetry.md).