Merge pull request #89095 from vhorne/dns-priv-qs

toc update

Author: American-Dipper

.openpublishing.redirection.json

@@ -10790,6 +10790,16 @@
       "redirect_url": "/azure/dns/dns-reverse-dns-for-azure-services",
       "redirect_document_id": false
     },
+    {
+      "source_path": "articles/dns/scripts/traffic-manager-cli-create-dns-zone-record.md",
+      "redirect_url": "/azure/dns/scripts/dns-cli-create-dns-zone-record",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "articles/dns/private-dns-portal.md",
+      "redirect_url": "/azure/dns/private-dns-getstarted-portal",
+      "redirect_document_id": false
+    },
     {
       "source_path": "articles/data-lake-analytics/data-lake-analytics-get-started-net-sdk.md",
       "redirect_url": "/azure/data-lake-analytics/data-lake-analytics-get-started-cli2",

articles/dns/TOC.yml

@@ -9,12 +9,22 @@
 - name: Quickstarts
   expanded: true
   items:
-  - name: Name resolution - portal
-    href: dns-getstarted-portal.md
-  - name: Name resolution - PowerShell
-    href: dns-getstarted-powershell.md
-  - name: Name resolution - CLI
-    href: dns-getstarted-cli.md
+  - name: Public DNS
+    items:
+    - name: Create a public zone - portal
+      href: dns-getstarted-portal.md
+    - name: Create a public zone - PowerShell
+      href: dns-getstarted-powershell.md
+    - name: Create a public zone - CLI
+      href: dns-getstarted-cli.md
+  - name: Private DNS
+    items:
+    - name: Create a private zone - portal
+      href: private-dns-getstarted-portal.md
+    - name: Create a private zone - CLI
+      href: private-dns-getstarted-cli.md
+    - name: Create a private zone - PowerShell
+      href: private-dns-getstarted-powershell.md
 - name: Tutorials
   items:
   - name: Public DNS
@@ -29,11 +39,6 @@
       href: tutorial-alias-pip.md
     - name: Alias records for zone records
       href: tutorial-alias-rr.md
-  - name: Private DNS
-    items:
-    - name: Create private DNS zone and record
-      href: private-dns-portal.md
-
 - name: Samples
   items:
   - name: Azure CLI
@@ -64,12 +69,6 @@
       href: private-dns-scenarios.md
 - name: How to
   items:
-  - name: Private DNS
-    items:
-    - name: Create private zone - CLI
-      href: private-dns-getstarted-cli.md
-    - name: Create private zone - PowerShell
-      href: private-dns-getstarted-powershell.md
   - name: Public DNS
     items:
     - name: Alias records for load balanced web apps

articles/dns/cli-samples.md

@@ -1,29 +1,21 @@
 ---
-title: Azure CLI samples for Traffic Manager| Microsoft Docs
-description: Azure CLI samples for Traffic Manager
-services: traffic-manager
-documentationcenter: traffic-manager
+title: Azure CLI samples for DNS
+description: Azure CLI samples for DNS
+services: dns
 author: vhorne
-manager: jeconnoc
-editor: tysonn
-tags:
-ms.assetid:
-ms.service: traffic-manager
-ms.devlang: na
+ms.service: dns
 ms.topic: sample
-ms.tgt_pltfrm:
-ms.workload: infrastructure
-ms.date: 04/30/2018
+ms.date: 09/20/2019
 ms.author: victorh
 
 ---
-# Azure CLI samples for Traffic Manager
+# Azure CLI examples for Azure DNS
 
-The following table includes link to bash script for Traffic Manager built using the Azure CLI.
+The following table includes links to Azure CLI examples for Azure DNS.
 
 | | |
 |-|-|
-| [Create a DNS zone and record](./scripts/traffic-manager-cli-create-dns-zone-record.md) | Creates a DNS zone and record for a domain name. |
+| [Create a DNS zone and record](./scripts/dns-cli-create-dns-zone-record.md) | Creates a DNS zone and record for a domain name. |
 | | |
 
 

articles/dns/dns-faq-private.md

@@ -5,15 +5,12 @@ services: dns
 author: vhorne
 ms.service: dns
 ms.topic: article
-ms.date: 6/12/2019
+ms.date: 09/20/2019
 ms.author: victorh
 ---
 # Azure Private DNS FAQ
 
-> [!IMPORTANT]
-> Azure Private DNS is currently in public preview.
-> This preview version is provided without a service level agreement, and it's not recommended for production workloads. Certain features might not be supported or might have constrained capabilities.
-> For more information, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
+[!INCLUDE [private-dns-public-preview-notice](../../includes/private-dns-public-preview-notice.md)]
 
 ## Does Azure DNS support private domains?
 
@@ -23,11 +20,11 @@ For information on other internal DNS options in Azure, see [Name resolution for
 
 ## Will Azure DNS Private Zones work across Azure regions?
 
-Yes. Private Zones is supported for DNS resolution between virtual networks across Azure regions. Private Zones works even without explicitly peering the virtual networks. All the virtual networks must be specified as Resolution virtual networks for the private zone. Customers might need the virtual networks to be peered for TCP/HTTP traffic to flow from one region to another.
+Yes. Private Zones is supported for DNS resolution between virtual networks across Azure regions. Private Zones works even without explicitly peering the virtual networks. All the virtual networks must be specified as Resolution virtual networks for the private zone. You might need the virtual networks to be peered for TCP/HTTP traffic to flow from one region to another.
 
 ## Is connectivity to the Internet from virtual networks required for private zones?
 
-No. Private zones work along with virtual networks. Customers use them to manage domains for virtual machines or other resources within and across virtual networks. Internet connectivity isn't required for name resolution.
+No. Private zones work along with virtual networks. You use them to manage domains for virtual machines or other resources within and across virtual networks. Internet connectivity isn't required for name resolution.
 
 ## Can the same private zone be used for several virtual networks for resolution?
 

articles/dns/private-dns-getstarted-cli.md

@@ -1,34 +1,34 @@
 ---
-title: Create an Azure DNS private zone using the Azure CLI
-description: In this procedure, you create and test a private DNS zone and record in Azure DNS. This is a step-by-step guide to create and manage your first private DNS zone and record using Azure CLI.
+title: Quickstart - Create an Azure private DNS zone using the Azure CLI
+description: In this quickstart, you create and test a private DNS zone and record in Azure DNS. This is a step-by-step guide to create and manage your first private DNS zone and record using Azure CLI.
 services: dns
 author: vhorne
 ms.service: dns
-ms.topic: article
-ms.date: 6/13/2019
+ms.topic: quickstart
+ms.date: 09/20/2019
 ms.author: victorh
-#Customer intent: As an experienced network administrator I want to create an  Azure DNS private zone, so I can resolve host names on my private virtual networks.
+#Customer intent: As an experienced network administrator I want to create an  Azure private DNS zone, so I can resolve host names on my private virtual networks.
 ---
 
-# Create an Azure DNS private zone using the Azure CLI
+# Create an Azure private DNS zone using the Azure CLI
 
 [!INCLUDE [private-dns-public-preview-notice](../../includes/private-dns-public-preview-notice.md)]
 
-This procedure walks you through the steps to create your first private DNS zone and record using the Azure CLI.
+This quickstart walks you through the steps to create your first private DNS zone and record using the Azure CLI.
 
 A DNS zone is used to host the DNS records for a particular domain. To start hosting your domain in Azure DNS, you need to create a DNS zone for that domain name. Each DNS record for your domain is then created inside this DNS zone. To publish a private DNS zone to your virtual network, you specify the list of virtual networks that are allowed to resolve records within the zone.  These are called *linked* virtual networks. When autoregistration is enabled, Azure DNS also updates the zone records whenever a virtual machine is created, changes its' IP address, or is deleted.
 
-In this procedure, you learn how to:
+In this quickstart, you learn how to:
 
 > [!div class="checklist"]
-> * Create a DNS private zone
+> * Create a private DNS zone
 > * Create test virtual machines
 > * Create an additional DNS record
 > * Test the private zone
 
 If you don’t have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
 
-If you prefer, you can complete this procedure using [Azure PowerShell](private-dns-getstarted-powershell.md).
+If you prefer, you can complete this quickstart using [Azure PowerShell](private-dns-getstarted-powershell.md).
 
 [!INCLUDE [cloud-shell-try-it.md](../../includes/cloud-shell-try-it.md)]
 
@@ -40,7 +40,7 @@ First, create a resource group to contain the DNS zone:
 az group create --name MyAzureResourceGroup --location "East US"
 ```
 
-## Create a DNS private zone
+## Create a private DNS zone
 
 The following example creates a virtual network named **myAzureVNet**. Then it creates a DNS zone named **private.contoso.com** in the **MyAzureResourceGroup** resource group, links the DNS zone to the **MyAzureVnet** virtual network, and enables automatic registration.
 
@@ -202,16 +202,14 @@ Repeat for myVM02.
 
 ## Delete all resources
 
-When no longer needed, delete the **MyAzureResourceGroup** resource group to delete the resources created in this procedure.
+When no longer needed, delete the **MyAzureResourceGroup** resource group to delete the resources created in this quickstart.
 
 ```azurecli
 az group delete --name MyAzureResourceGroup
 ```
 
 ## Next steps
 
-In this procedure, you deployed a private DNS zone, created a DNS record, and tested the zone.
-Next, you can learn more about private DNS zones.
-
 > [!div class="nextstepaction"]
-> [Using Azure DNS for private domains](private-dns-overview.md)
+> [Azure DNS Private Zones scenarios](private-dns-scenarios.md)
+

articles/dns/private-dns-portal.md renamed to articles/dns/private-dns-getstarted-portal.md

@@ -1,27 +1,27 @@
 ---
-title: Create an Azure DNS private zone using the Azure portal
-description: In this tutorial, you create and test a private DNS zone and record in Azure DNS. This is a step-by-step guide to create and manage your first private DNS zone and record using the Azure portal.
+title: Quickstart - Create an Azure private DNS zone using the Azure portal
+description: In this quickstart, you create and test a private DNS zone and record in Azure DNS. This is a step-by-step guide to create and manage your first private DNS zone and record using the Azure portal.
 services: dns
 author: vhorne
 ms.service: dns
-ms.topic: tutorial
-ms.date: 6/15/2019
+ms.topic: quickstart
+ms.date: 09/20/2019
 ms.author: victorh
-#Customer intent: As an experienced network administrator I want to create an  Azure DNS private zone, so I can resolve host names on my private virtual networks.
+#Customer intent: As an experienced network administrator I want to create an  Azure private DNS zone, so I can resolve host names on my private virtual networks.
 ---
 
-# Tutorial: Create an Azure DNS private zone using the Azure portal
+# Quickstart: Create an Azure private DNS zone using the Azure portal
 
-This tutorial walks you through the steps to create your first private DNS zone and record using the Azure portal.
+This quickstart walks you through the steps to create your first private DNS zone and record using the Azure portal.
 
 [!INCLUDE [private-dns-public-preview-notice](../../includes/private-dns-public-preview-notice.md)]
 
 A DNS zone is used to host the DNS records for a particular domain. To start hosting your domain in Azure DNS, you need to create a DNS zone for that domain name. Each DNS record for your domain is then created inside this DNS zone. To publish a private DNS zone to your virtual network, you specify the list of virtual networks that are allowed to resolve records within the zone.  These are called *linked* virtual networks. When autoregistration is enabled, Azure DNS also updates the zone records whenever a virtual machine is created, changes its' IP address, or is deleted.
 
-In this tutorial, you learn how to:
+In this quickstart, you learn how to:
 
 > [!div class="checklist"]
-> * Create a DNS private zone
+> * Create a private DNS zone
 > * Create a virtual network
 > * Link the virtual network
 > * Create test virtual machines
@@ -30,9 +30,9 @@ In this tutorial, you learn how to:
 
 If you don’t have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
 
-If you prefer, you can complete this tutorial using [Azure PowerShell](private-dns-getstarted-powershell.md) or [Azure CLI](private-dns-getstarted-cli.md).
+If you prefer, you can complete this quickstart using [Azure PowerShell](private-dns-getstarted-powershell.md) or [Azure CLI](private-dns-getstarted-cli.md).
 
-## Create a DNS private zone
+## Create a private DNS zone
 
 The following example creates a DNS zone called **private.contoso.com** in a resource group called **MyAzureResourceGroup**.
 
@@ -173,13 +173,11 @@ Repeat for myVM02.
 
 ## Delete all resources
 
-When no longer needed, delete the **MyAzureResourceGroup** resource group to delete the resources created in this tutorial.
+When no longer needed, delete the **MyAzureResourceGroup** resource group to delete the resources created in this quickstart.
 
 
 ## Next steps
 
-In this tutorial, you deployed a private DNS zone, created a DNS record, and tested the zone.
-Next, you can learn more about private DNS zones.
-
 > [!div class="nextstepaction"]
-> [Using Azure DNS for private domains](private-dns-overview.md)
+> [Azure DNS Private Zones scenarios](private-dns-scenarios.md)
+

articles/dns/private-dns-getstarted-powershell.md

@@ -1,16 +1,16 @@
 ---
-title: Create an Azure DNS private zone using Azure PowerShell
+title: Quickstart - Create an Azure private DNS zone using Azure PowerShell
 description: In this article, you create and test a private DNS zone and record in Azure DNS. This is a step-by-step guide to create and manage your first private DNS zone and record using Azure PowerShell.
 services: dns
 author: vhorne
 ms.service: dns
-ms.topic: article
-ms.date: 06/14/2019
+ms.topic: quickstart
+ms.date: 09/20/2019
 ms.author: victorh
-#Customer intent: As an experienced network administrator I want to create an  Azure DNS private zone, so I can resolve host names on my private virtual networks.
+#Customer intent: As an experienced network administrator I want to create an  Azure private DNS zone, so I can resolve host names on my private virtual networks.
 ---
 
-# Create an Azure DNS private zone using Azure PowerShell
+# Create an Azure private DNS zone using Azure PowerShell
 
 [!INCLUDE [private-dns-public-preview-notice](../../includes/private-dns-public-preview-notice.md)]
 
@@ -23,7 +23,7 @@ A DNS zone is used to host the DNS records for a particular domain. To start hos
 In this article, you learn how to:
 
 > [!div class="checklist"]
-> * Create a DNS private zone
+> * Create a private DNS zone
 > * Create test virtual machines
 > * Create an additional DNS record
 > * Test the private zone
@@ -32,7 +32,7 @@ In this article, you learn how to:
 
 If you don’t have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
 
-If you prefer, you can complete this procedure using [Azure CLI](private-dns-getstarted-cli.md).
+If you prefer, you can complete this quickstart using [Azure CLI](private-dns-getstarted-cli.md).
 
 ## Create the resource group
 
@@ -42,7 +42,7 @@ First, create a resource group to contain the DNS zone:
 New-AzResourceGroup -name MyAzureResourceGroup -location "eastus"
 ```
 
-## Create a DNS private zone
+## Create a private DNS zone
 
 A DNS zone is created by using the `New-AzPrivateDnsZone` cmdlet.
 
@@ -205,7 +205,5 @@ Remove-AzResourceGroup -Name MyAzureResourceGroup
 
 ## Next steps
 
-In this article, you deployed a private DNS zone, created a DNS record, and tested the zone.
-Next, you can learn more about private DNS zones.
-
-* [Using Azure DNS for private domains](private-dns-overview.md)
+> [!div class="nextstepaction"]
+> [Azure DNS Private Zones scenarios](private-dns-scenarios.md)

articles/dns/scripts/traffic-manager-cli-create-dns-zone-record.md renamed to articles/dns/scripts/dns-cli-create-dns-zone-record.md

@@ -1,20 +1,11 @@
 ---
-title: CLI Example - Create a DNS zone and record for a domain name - Azure | Microsoft Docs
+title: Azure CLI Example - Create a DNS zone and record for a domain name
 description: This Azure CLI script example shows how to create a DNS zone and record for a domain name
-services: load-balancer
-documentationcenter: traffic-manager
+services: dns
 author: vhorne
-manager: jeconnoc
-editor: tysonn
-tags: 
-
-ms.assetid:
-ms.service: traffic-manager
-ms.devlang: azurecli
+ms.service: dns
 ms.topic: sample
-ms.tgt_pltfrm: 
-ms.workload: infrastructure
-ms.date: 04/30/2018
+ms.date: 09/20/2019
 ms.author: victorh
 ---
 
@@ -28,32 +19,7 @@ This Azure CLI script example creates a DNS zone and record for a domain name.
 
 ## Sample script
 
-```azurecli-interactive
-
-# Create a resource group.
-az group create \
-  -n myResourceGroup \
-  -l eastus
-
-# Create a DNS zone. Substitute zone name "contoso.com" with the values for your own.
-
-az network dns zone create \
-  -g MyResourceGroup \
-  -n contoso.com
-
-# Create a DNS record. Substitute zone name "contoso.com" and IP address "1.2.3.4* with the values for your own.
-
-az network dns record-set a add-record \
-  -g MyResourceGroup \
-  -z contoso.com \
-  -n www \
-  -a 1.2.3.4
-
-# Get a list the DNS records in your zone
-az network dns record-set list \
-  -g MyResourceGroup \ 
-  -z contoso.com
-```
+[!code-azurecli-interactive[main](../../../cli_scripts/dns/create-dns-zone-and-record/create-dns-zone-and-record.sh "Create DNS zone and record")]
 
 ## Clean up deployment