Merge pull request #235692 from halkazwini/ip-asn-ps

Internet Peering: Updates: Associate peer ASN to Azure subscription using PowerShell

Author: prmerger-automator[bot]

articles/internet-peering/howto-subscription-association-powershell.md

@@ -1,11 +1,11 @@
 ---
 title: Associate peer ASN to Azure subscription - PowerShell
-description: Associate peer ASN to Azure subscription using PowerShell.
+description: Learn how to associate peer ASN to Azure subscription using PowerShell.
 services: internet-peering
 author: halkazwini
 ms.service: internet-peering
 ms.topic: how-to
-ms.date: 01/23/2023
+ms.date: 04/24/2023
 ms.author: halkazwini 
 ms.custom: template-how-to, devx-track-azurepowershell, engagement-fy23
 ---
@@ -16,7 +16,7 @@ ms.custom: template-how-to, devx-track-azurepowershell, engagement-fy23
 > - [Azure portal](howto-subscription-association-portal.md)
 > - [PowerShell](howto-subscription-association-powershell.md)
 
-Before you submit a peering request, you should first associate your ASN with Azure subscription using the steps below.
+Before you submit a peering request, you should first associate your ASN with Azure subscription using the steps in this article.
 
 If you prefer, you can complete this guide using the [Azure portal](howto-subscription-association-portal.md).
 
@@ -29,13 +29,13 @@ If you prefer, you can complete this guide using the [Azure portal](howto-subscr
 [!INCLUDE [Account](./includes/account-powershell.md)]
 
 ### Register for peering resource provider
-Register for peering resource provider in your subscription using the command below. If you don't execute this, then Azure resources required to set up peering aren't accessible.
+Register for peering resource provider in your subscription using [Register-AzResourceProvider](/powershell/module/az.resources/register-azresourceprovider). If you don't execute this, then Azure resources required to set up peering aren't accessible.
 
 ```powershell
 Register-AzResourceProvider -ProviderNamespace Microsoft.Peering
 ```
 
-You can check the registration status using the commands below:
+You can check the registration status using [Get-AzResourceProvider](/powershell/module/az.resources/get-azresourceprovider):
 ```powershell
 Get-AzResourceProvider -ProviderNamespace Microsoft.Peering
 ```
@@ -48,12 +48,8 @@ Get-AzResourceProvider -ProviderNamespace Microsoft.Peering
 Below is an example to update peer information.
 
 ```powershell
-New-AzPeerAsn `
-    -Name "Contoso_1234" `
-    -PeerName "Contoso" `
-    -PeerAsn 1234 `
-    -Email [email protected], [email protected] `
-    -Phone "+1 (555) 555-5555"
+$contactDetails = New-AzPeerAsnContactDetail -Role Noc -Email "[email protected]" -Phone "+1 (555) 555-5555"
+New-AzPeerAsn -Name "Contoso_1234" -PeerName "Contoso" -PeerAsn 1234 -ContactDetail $contactDetails
 ```
 
 > [!NOTE]
@@ -63,11 +59,11 @@ A subscription can have multiple ASNs. Update the peering information for each A
 
 Peers are expected to have a complete and up-to-date profile on [PeeringDB](https://www.peeringdb.com). We use this information during registration to validate the peer's details such as NOC information, technical contact information, and their presence at the peering facilities etc.
 
-Note that in place of **{subscriptionId}** in the output above, actual subscription ID will be displayed.
+In place of **{subscriptionId}** in the output, actual subscription ID is displayed.
 
 ## View status of a PeerASN
 
-Check for ASN Validation state using the command below:
+Check for ASN Validation state using [Get-AzPeerAsn](/powershell/module/az.peering/get-azpeerasn):
 
 ```powershell
 Get-AzPeerAsn