az network private-dns zone

Manage Private DNS zones.

Commands

az network private-dns zone create

Create a Private DNS zone.

az network private-dns zone delete

Delete a Private DNS zone.

az network private-dns zone export

Export a Private DNS zone as a DNS zone file.

az network private-dns zone import

Create a Private DNS zone using a DNS zone file.

az network private-dns zone list

List Private DNS zones.

az network private-dns zone show

Get a Private DNS zone.

az network private-dns zone update

Update a Private DNS zone's properties. Does not modify Private DNS records or virtual network links within the zone.

az network private-dns zone wait

Place the CLI in a waiting state until a condition of the Private DNS zone is met.

az network private-dns zone create

Create a Private DNS zone.

az network private-dns zone create --name
                                   --resource-group
                                   [--no-wait]
                                   [--tags]

Examples

Create a Private DNS zone using a fully qualified domain name.

az network private-dns zone create -g MyResourceGroup -n www.mysite.com

Required Parameters

--name -n

The name of the Private DNS zone.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

--no-wait

Do not wait for the long-running operation to finish.

default value: False
--tags

Resource tags for the Private DNS zone.

az network private-dns zone delete

Delete a Private DNS zone.

All DNS records in the zone will also be deleted. This operation cannot be undone. Private DNS zone cannot be deleted unless all virtual network links to it are removed.

az network private-dns zone delete --name
                                   --resource-group
                                   [--if-match]
                                   [--no-wait]
                                   [--yes]

Examples

Delete a Private DNS zone using a fully qualified domain name.

az network private-dns zone delete -g MyResourceGroup -n www.mysite.com

Required Parameters

--name -n

The name of the Private DNS zone.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

--if-match

The ETag of the Private DNS zone. Omit this value to always delete the current zone. Specify the last-seen ETag value to prevent accidentally deleting any concurrent changes.

--no-wait

Do not wait for the long-running operation to finish.

default value: False
--yes -y

Do not prompt for confirmation.

default value: False

az network private-dns zone export

Export a Private DNS zone as a DNS zone file.

az network private-dns zone export --name
                                   --resource-group
                                   [--file-name]

Examples

Export a Private DNS zone as a DNS zone file.

az network private-dns zone export -g MyResourceGroup -n www.mysite.com -f mysite_com_zone.txt

Required Parameters

--name -n

The name of the Private DNS zone.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

--file-name -f

Path to the Private DNS zone file to save.

az network private-dns zone import

Create a Private DNS zone using a DNS zone file.

az network private-dns zone import --file-name
                                   --name
                                   --resource-group

Examples

Import a local zone file into a Private DNS zone resource.

az network private-dns zone import -g MyResourceGroup -n MyZone -f /path/to/zone/file

Required Parameters

--file-name -f

Path to the Private DNS zone file to import.

--name -n

The name of the Private DNS zone.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

az network private-dns zone list

List Private DNS zones.

az network private-dns zone list [--resource-group]

Examples

List Private DNS zones in a resource group.

az network private-dns zone list -g MyResourceGroup

Optional Parameters

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

az network private-dns zone show

Get a Private DNS zone.

az network private-dns zone show --name
                                 --resource-group

Examples

Get a Private DNS zone using a fully qualified domain name.

az network private-dns zone show -g MyResourceGroup -n www.mysite.com

Required Parameters

--name -n

The name of the Private DNS zone.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

az network private-dns zone update

Update a Private DNS zone's properties. Does not modify Private DNS records or virtual network links within the zone.

az network private-dns zone update --name
                                   --resource-group
                                   [--add]
                                   [--force-string]
                                   [--if-match]
                                   [--no-wait]
                                   [--remove]
                                   [--set]
                                   [--tags]

Examples

Update a Private DNS zone properties to change the user-defined value of a previously set tag.

az network private-dns zone update -g MyResourceGroup -n www.mysite.com --tags CostCenter=Marketing

Required Parameters

--name -n

The name of the Private DNS zone.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

--add

Add an object to a list of objects by specifying a path and key value pairs. Example: --add property.listProperty <key=value, string or JSON string>.

default value: []
--force-string

When using 'set' or 'add', preserve string literals instead of attempting to convert to JSON.

default value: False
--if-match

The ETag of the Private DNS zone. Omit this value to always overwrite the current zone. Specify the last-seen ETag value to prevent accidentally overwriting any concurrent changes.

--no-wait

Do not wait for the long-running operation to finish.

default value: False
--remove

Remove a property or an element from a list. Example: --remove property.list OR --remove propertyToRemove.

default value: []
--set

Update an object by specifying a property path and value to set. Example: --set property1.property2=.

default value: []
--tags

Resource tags for the Private DNS zone.

az network private-dns zone wait

Place the CLI in a waiting state until a condition of the Private DNS zone is met.

az network private-dns zone wait --name
                                 --resource-group
                                 [--created]
                                 [--custom]
                                 [--deleted]
                                 [--exists]
                                 [--interval]
                                 [--timeout]
                                 [--updated]

Examples

Pause executing next line of CLI script until the Private DNS zone is successfully provisioned.

az network private-dns zone wait -g MyResourceGroup -n www.mysite.com --created

Required Parameters

--name -n

The name of the Private DNS zone.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

--created

Wait until created with 'provisioningState' at 'Succeeded'.

default value: False
--custom

Wait until the condition satisfies a custom JMESPath query. E.g. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Wait until deleted.

default value: False
--exists

Wait until the resource exists.

default value: False
--interval

Polling interval in seconds.

default value: 30
--timeout

Maximum wait in seconds.

default value: 3600
--updated

Wait until updated with provisioningState at 'Succeeded'.

default value: False