Skip to content

Commit 58616e7

Browse files
committed
Merge remote-tracking branch 'refs/remotes/Microsoft/master'
2 parents f07831c + 0ca49ca commit 58616e7

23 files changed

+514
-447
lines changed

articles/dns/dns-domain-delegation.md

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,6 @@ services: dns
55
documentationcenter: na
66
author: sdwheeler
77
manager: carmonm
8-
editor: ''
98

109
ms.assetid: 257da6ec-d6e2-4b6f-ad76-ee2dde4efbcc
1110
ms.service: dns
@@ -158,26 +157,26 @@ The following PowerShell example demonstrates how this works. The same steps can
158157
First, we create the parent and child zones. These can be in same resource group or different resource groups.
159158

160159
```powershell
161-
$parent = New-AzureRmDnsZone -Name contoso.com -ResourceGroupName RG1
162-
$child = New-AzureRmDnsZone -Name partners.contoso.com -ResourceGroupName RG1
160+
$parent = New-AzureRmDnsZone -Name contoso.com -ResourceGroupName RG1
161+
$child = New-AzureRmDnsZone -Name partners.contoso.com -ResourceGroupName RG1
163162
```
164163

165164
#### Step 2. Retrieve NS records
166165

167166
Next, we retrieve the authoritative NS records from child zone as shown in the next example. This contains the name servers assigned to the child zone.
168167

169168
```powershell
170-
$child_ns_recordset = Get-AzureRmDnsRecordSet -Zone $child -Name "@" -RecordType NS
169+
$child_ns_recordset = Get-AzureRmDnsRecordSet -Zone $child -Name "@" -RecordType NS
171170
```
172171

173172
#### Step 3. Delegate the child zone
174173

175174
Create corresponding NS record set in the parent zone to complete the delegation. Note that the record set name in the parent zone matches the child zone name, in this case "partners".
176175

177176
```powershell
178-
$parent_ns_recordset = New-AzureRmDnsRecordSet -Zone $parent -Name "partners" -RecordType NS -Ttl 3600
179-
$parent_ns_recordset.Records = $child_ns_recordset.Records
180-
Set-AzureRmDnsRecordSet -RecordSet $parent_ns_recordset
177+
$parent_ns_recordset = New-AzureRmDnsRecordSet -Zone $parent -Name "partners" -RecordType NS -Ttl 3600
178+
$parent_ns_recordset.Records = $child_ns_recordset.Records
179+
Set-AzureRmDnsRecordSet -RecordSet $parent_ns_recordset
181180
```
182181

183182
### To verify name resolution is working

articles/dns/dns-getstarted-create-dnszone-cli.md

Lines changed: 8 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,6 @@ services: dns
55
documentationcenter: na
66
author: sdwheeler
77
manager: carmonm
8-
editor: ''
98

109
ms.assetid: 1514426a-133c-491a-aa27-ee0962cea9dc
1110
ms.service: dns
@@ -41,31 +40,31 @@ You can install Azure CLI for Windows, Linux, or MAC. The following steps need t
4140
All the network provider commands on CLI can be found using the following command:
4241

4342
```azurecli
44-
azure network
43+
azure network
4544
```
4645

4746
### 2. Switch CLI mode
4847

4948
Azure DNS uses Azure Resource Manager. Make sure you switch CLI mode to use ARM commands.
5049

5150
```azurecli
52-
azure config mode arm
51+
azure config mode arm
5352
```
5453

5554
### 3. Sign in to your Azure account
5655

5756
You will be prompted to authenticate with your credentials. Keep in mind that you can only use ORGID accounts.
5857

5958
```azurecli
60-
azure login -u "username"
59+
azure login -u "username"
6160
```
6261

6362
### 4. Select the subscription
6463

6564
Choose which of your Azure subscriptions to use.
6665

6766
```azurecli
68-
azure account set "subscription name"
67+
azure account set "subscription name"
6968
```
7069

7170
### 5. Create a resource group
@@ -75,15 +74,15 @@ Azure Resource Manager requires that all resource groups specify a location. Thi
7574
You can skip this step if you are using an existing resource group.
7675

7776
```azurecli
78-
azure group create -n myresourcegroup --location "West US"
77+
azure group create -n myresourcegroup --location "West US"
7978
```
8079

8180
### 6. Register
8281

8382
The Azure DNS service is managed by the Microsoft.Network resource provider. Your Azure subscription needs to be registered to use this resource provider before you can use Azure DNS. This is a one-time operation for each subscription.
8483

8584
```azurecli
86-
azure provider register --namespace Microsoft.Network
85+
azure provider register --namespace Microsoft.Network
8786
```
8887

8988
## Step 2 - Create a DNS zone
@@ -99,7 +98,7 @@ The example below creates a DNS zone called *contoso.com* in the resource group
9998
Use the example to create your DNS zone, substituting the values for your own.
10099

101100
```azurecli
102-
azure network dns zone create myresourcegroup contoso.com
101+
azure network dns zone create myresourcegroup contoso.com
103102
```
104103

105104
### To create a DNS zone and tags.
@@ -109,7 +108,7 @@ Azure DNS CLI supports tags of DNS zones specified by using the optional *-Tag*
109108
Use the example below to create a DNS zone and tags, substituting the values for your own.
110109

111110
```azurecli
112-
azure network dns zone create myresourcegroup contoso.com -t "project=demo";"env=test"
111+
azure network dns zone create myresourcegroup contoso.com -t "project=demo";"env=test"
113112
```
114113

115114
## View records

articles/dns/dns-getstarted-create-dnszone.md

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,6 @@ services: dns
55
documentationcenter: na
66
author: sdwheeler
77
manager: carmonm
8-
editor: ''
98

109
ms.assetid: d78583b7-e669-435c-819b-7605cf791b0e
1110
ms.service: dns
@@ -67,19 +66,19 @@ Open your PowerShell console and connect to your account. For more information,
6766
Use the following sample to help you connect:
6867

6968
```powershell
70-
Login-AzureRmAccount
69+
Login-AzureRmAccount
7170
```
7271

7372
Check the subscriptions for the account.
7473

7574
```powershell
76-
Get-AzureRmSubscription
75+
Get-AzureRmSubscription
7776
```
7877

7978
Specify the subscription that you want to use.
8079

8180
```powershell
82-
Select-AzureRmSubscription -SubscriptionName "Replace_with_your_subscription_name"
81+
Select-AzureRmSubscription -SubscriptionName "Replace_with_your_subscription_name"
8382
```
8483

8584
## Step 2 - Create a resource group
@@ -89,15 +88,15 @@ Azure Resource Manager requires that all resource groups specify a location. Thi
8988
You can skip this step if you are using an existing resource group.
9089

9190
```powershell
92-
New-AzureRmResourceGroup -Name MyAzureResourceGroup -location "West US"
91+
New-AzureRmResourceGroup -Name MyAzureResourceGroup -location "West US"
9392
```
9493

9594
## Step 3 - Register
9695

9796
The Azure DNS service is managed by the Microsoft.Network resource provider. Your Azure subscription needs to be registered to use this resource provider before you can use Azure DNS. This is a one-time operation for each subscription.
9897

9998
```powershell
100-
Register-AzureRmResourceProvider -ProviderNamespace Microsoft.Network
99+
Register-AzureRmResourceProvider -ProviderNamespace Microsoft.Network
101100
```
102101

103102
## Step 4 - Create a DNS zone
@@ -112,15 +111,15 @@ A DNS zone is created by using the `New-AzureRmDnsZone` cmdlet. There are exampl
112111
The example below creates a DNS zone called *contoso.com* in the resource group called *MyResourceGroup*. Use the example to create a DNS zone, substituting the values for your own.
113112

114113
```powershell
115-
New-AzureRmDnsZone -Name contoso.com -ResourceGroupName MyAzureResourceGroup
114+
New-AzureRmDnsZone -Name contoso.com -ResourceGroupName MyAzureResourceGroup
116115
```
117116

118117
### To create a DNS zone with tags
119118

120119
The following example shows how to create a DNS zone with two tags, *project = demo* and *env = test*. Use the example to create a DNS zone, substituting the values for your own.
121120

122121
```powershell
123-
New-AzureRmDnsZone -Name contoso.com -ResourceGroupName MyAzureResourceGroup -Tag @( @{ Name="project"; Value="demo" }, @{ Name="env"; Value="test" } )
122+
New-AzureRmDnsZone -Name contoso.com -ResourceGroupName MyAzureResourceGroup -Tag @( @{ Name="project"; Value="demo" }, @{ Name="env"; Value="test" } )
124123
```
125124

126125
## View records

articles/dns/dns-getstarted-create-recordset-cli.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,6 @@ services: dns
55
documentationcenter: na
66
author: sdwheeler
77
manager: carmonm
8-
editor: ''
98

109
ms.assetid: 02b897d3-e83b-4257-b96d-5c29aa59e843
1110
ms.service: dns
@@ -41,7 +40,7 @@ To create record set, use `azure network dns record-set create`. Specify the res
4140
*Usage: network dns record-set create \<resource-group\> \<dns-zone-name\> \<name\> \<type\> \<ttl\>*
4241

4342
```azurecli
44-
azure network dns record-set create myresourcegroup contoso.com www A 60
43+
azure network dns record-set create myresourcegroup contoso.com www A 60
4544
```
4645

4746
### 2. Add records
@@ -55,7 +54,7 @@ You can add IPv4 *A* records to the "www" record set by using the following comm
5554
*Usage: network dns record-set add-record \<resource-group\> \<dns-zone-name\> \<record-set-name\> \<type\>*
5655

5756
```azurecli
58-
azure network dns record-set add-record myresourcegroup contoso.com www A -a 134.170.185.46
57+
azure network dns record-set add-record myresourcegroup contoso.com www A -a 134.170.185.46
5958
```
6059

6160
## Additional record type examples

articles/dns/dns-getstarted-create-recordset.md

Lines changed: 10 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,6 @@ services: dns
55
documentationcenter: na
66
author: sdwheeler
77
manager: carmonm
8-
editor: ''
98

109
ms.assetid: a8068c5a-f248-4e97-be97-8bd0d79eeffd
1110
ms.service: dns
@@ -41,19 +40,19 @@ This section describes how to create a record set and record.
4140
Open your PowerShell console and connect to your account. Use the following sample to help you connect:
4241

4342
```powershell
44-
Login-AzureRmAccount
43+
Login-AzureRmAccount
4544
```
4645

4746
Check the subscriptions for the account.
4847

4948
```powershell
50-
Get-AzureRmSubscription
49+
Get-AzureRmSubscription
5150
```
5251

5352
Specify the subscription that you want to use.
5453

5554
```powershell
56-
Select-AzureRmSubscription -SubscriptionName "Replace_with_your_subscription_name"
55+
Select-AzureRmSubscription -SubscriptionName "Replace_with_your_subscription_name"
5756
```
5857

5958
For more information about working with PowerShell, see [Using Windows PowerShell with Resource Manager](../powershell-azure-resource-manager.md).
@@ -67,22 +66,22 @@ To create a record set in the apex of the zone (in this case, "contoso.com"), us
6766
The following example creates a record set with the relative name "www" in the DNS Zone "contoso.com". The fully-qualified name of the record set is "www.contoso.com". The record type is "A", and the TTL is 60 seconds. After completing this step, you will have an empty "www" record set that is assigned to the variable *$rs*.
6867

6968
```powershell
70-
$rs = New-AzureRmDnsRecordSet -Name "www" -RecordType "A" -ZoneName "contoso.com" -ResourceGroupName "MyAzureResourceGroup" -Ttl 60
69+
$rs = New-AzureRmDnsRecordSet -Name "www" -RecordType "A" -ZoneName "contoso.com" -ResourceGroupName "MyAzureResourceGroup" -Ttl 60
7170
```
7271

7372
#### If a record set already exists
7473

7574
If a record set already exists, the command fails unless the *-Overwrite* switch is used. The *-Overwrite* option triggers a confirmation prompt, which can be suppressed by using the *-Force* switch.
7675

7776
```powershell
78-
$rs = New-AzureRmDnsRecordSet -Name www -RecordType A -Ttl 300 -ZoneName contoso.com -ResouceGroupName MyAzureResouceGroup [-Tag $tags] [-Overwrite] [-Force]
77+
$rs = New-AzureRmDnsRecordSet -Name www -RecordType A -Ttl 300 -ZoneName contoso.com -ResouceGroupName MyAzureResouceGroup [-Tag $tags] [-Overwrite] [-Force]
7978
```
8079

8180
In this example, you specify the zone by using the zone name and resource group name. Alternatively, you can specify a zone object, as returned by `Get-AzureRmDnsZone` or `New-AzureRmDnsZone`.
8281

8382
```powershell
84-
$zone = Get-AzureRmDnsZone -Name contoso.com -ResourceGroupName MyAzureResourceGroup
85-
$rs = New-AzureRmDnsRecordSet -Name www -RecordType A -Ttl 300 -Zone $zone [-Tag $tags] [-Overwrite] [-Force]
83+
$zone = Get-AzureRmDnsZone -Name contoso.com -ResourceGroupName MyAzureResourceGroup
84+
$rs = New-AzureRmDnsRecordSet -Name www -RecordType A -Ttl 300 -Zone $zone [-Tag $tags] [-Overwrite] [-Force]
8685
```
8786

8887
`New-AzureRmDnsRecordSet` returns a local object that represents the record set that was created in Azure DNS.
@@ -94,16 +93,16 @@ To use the newly created "www" record set, you need to add records to it. You ca
9493
Adding records to a record set by using `Add-AzureRmDnsRecordConfig` is an offline operation. Only the local variable *$rs* is updated.
9594

9695
```powershell
97-
Add-AzureRmDnsRecordConfig -RecordSet $rs -Ipv4Address 134.170.185.46
98-
Add-AzureRmDnsRecordConfig -RecordSet $rs -Ipv4Address 134.170.188.221
96+
Add-AzureRmDnsRecordConfig -RecordSet $rs -Ipv4Address 134.170.185.46
97+
Add-AzureRmDnsRecordConfig -RecordSet $rs -Ipv4Address 134.170.188.221
9998
```
10099

101100
### 4. Commit the changes
102101

103102
Commit the changes to the record set. Use `Set-AzureRmDnsRecordSet` to upload the changes to the record set to Azure DNS.
104103

105104
```powershell
106-
Set-AzureRmDnsRecordSet -RecordSet $rs
105+
Set-AzureRmDnsRecordSet -RecordSet $rs
107106
```
108107

109108
### 5. Retrieve the record set

articles/dns/dns-import-export.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,6 @@ services: dns
55
documentationcenter: na
66
author: sdwheeler
77
manager: carmonm
8-
editor: ''
98

109
ms.assetid: f5797782-3005-4663-a488-ac0089809010
1110
ms.service: dns
@@ -68,9 +67,9 @@ The following notes provide additional technical details about the zone import p
6867

6968
The format of the Azure CLI command to import a DNS zone is:
7069

71-
```azurecli
72-
azure network dns zone import [options] <resource group> <zone name> <zone file name>
73-
```
70+
```azurecli
71+
azure network dns zone import [options] <resource group> <zone name> <zone file name>
72+
```
7473

7574
Values:
7675

@@ -169,7 +168,7 @@ After you have verified that the zone has been imported correctly, you will need
169168
The format of the Azure CLI command to import a DNS zone is:
170169
171170
```azurecli
172-
azure network dns zone export [options] <resource group> <zone name> <zone file name>
171+
azure network dns zone export [options] <resource group> <zone name> <zone file name>
173172
```
174173
175174
Values:

articles/dns/dns-operations-dnszones-cli.md

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,6 @@ services: dns
55
documentationcenter: na
66
author: sdwheeler
77
manager: carmonm
8-
editor: ''
98

109
ms.assetid: 8ab63bc4-5135-4ed8-8c0b-5f0712b9afed
1110
ms.service: dns
@@ -40,7 +39,7 @@ To create a new DNS zone to host your domain, see [Create an Azure DNS zone usin
4039
To retrieve a DNS zone, use `azure network dns zone show`:
4140

4241
```azurecli
43-
azure network dns zone show myresourcegroup contoso.com
42+
azure network dns zone show myresourcegroup contoso.com
4443
```
4544

4645
The operation returns a DNS zone with its id, number of record sets and tags.
@@ -50,15 +49,15 @@ The operation returns a DNS zone with its id, number of record sets and tags.
5049
To retrieve DNS zones within a resource group, use `azure network dns zone list`.
5150

5251
```azurecli
53-
azure network dns zone list myresourcegroup
52+
azure network dns zone list myresourcegroup
5453
```
5554

5655
## Update a DNS zone
5756

58-
Changes to a DNS zone resource can be made using `azure network dns zone set`. This does not update any of the DNS record sets within the zone (see [How to Manage DNS records](dns-operations-recordsets.md)). It's only used to update properties of the zone resource itself. This is currently limited to the Azure Resource Manager tags for the zone resource. See [Etags and Tags](dns-getstarted-create-dnszone.md#tagetag) for more information.
57+
Changes to a DNS zone resource can be made using `azure network dns zone set`. This does not update any of the DNS record sets within the zone (see [How to Manage DNS records](dns-operations-recordsets.md)). It's only used to update properties of the zone resource itself. This is currently limited to the Azure Resource Manager 'tags' for the zone resource. See [Etags and Tags](dns-getstarted-create-dnszone.md#tagetag) for more information.
5958

6059
```azurecli
61-
azure network dns zone set myresourcegroup contoso.com -t prod=value2
60+
azure network dns zone set myresourcegroup contoso.com -t prod=value2
6261
```
6362

6463
## Delete a DNS Zone
@@ -68,7 +67,7 @@ DNS zones can be deleted using `azure network dns zone delete`. This operation h
6867
Before deleting a DNS zone in Azure DNS, you will need to delete all records sets, except for the NS and SOA records at the root of the zone that were created automatically when the zone was created.
6968

7069
```azurecli
71-
azure network dns zone delete myresourcegroup contoso.com
70+
azure network dns zone delete myresourcegroup contoso.com
7271
```
7372

7473
## Next steps

articles/dns/dns-operations-dnszones.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,6 @@ services: dns
55
documentationcenter: na
66
author: sdwheeler
77
manager: carmonm
8-
editor: ''
98

109
ms.assetid: a67992ab-8166-4052-9b28-554c5a39e60c
1110
ms.service: dns
@@ -76,16 +75,17 @@ Use one of the following two ways to remove a DNS zone:
7675

7776
### Specify the zone using the zone name and resource group name
7877

79-
This operation has an optional *-Force* switch which suppresses the prompt to confirm you want to remove the DNS zone.
78+
This operation has an optional `-Force` switch which suppresses the prompt to confirm you want to remove the DNS zone.
8079

8180
```powershell
8281
Remove-AzureRmDnsZone -Name contoso.com -ResourceGroupName MyAzureResourceGroup [-Force]
8382
```
8483

8584
### Specify the zone using a $zone object
8685

87-
Specify the zone using a $zone object from `Get-AzureRmDnsZone`. This operation has an optional *-Force* switch which suppresses the prompt to confirm you want to remove the DNS zone. As with `Set-AzureRmDnsZone`, specifying the zone using a $zone object enables Etag checks to ensure concurrent changes are not deleted. <BR>
88-
The optional *-Overwrite* flag suppresses these checks. See [Etags and Tags](dns-getstarted-create-dnszone.md#tagetag) for more information.
86+
Specify the zone using a $zone object from `Get-AzureRmDnsZone`. This operation has an optional `-Force` switch which suppresses the prompt to confirm you want to remove the DNS zone. As with `Set-AzureRmDnsZone`, specifying the zone using a $zone object enables Etag checks to ensure concurrent changes are not deleted.
87+
88+
The optional `-Overwrite` flag suppresses these checks. See [Etags and Tags](dns-getstarted-create-dnszone.md#tagetag) for more information.
8989

9090
```powershell
9191
$zone = Get-AzureRmDnsZone -Name contoso.com -ResourceGroupName MyAzureResourceGroup

0 commit comments

Comments
 (0)