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 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.

--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.

--yes -y

Do not prompt for confirmation.

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>.

--force-string

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

--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 overwritting any concurrent changes.

--no-wait

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

--remove

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

--set

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

--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'.

--custom

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

--deleted

Wait until deleted.

--exists

Wait until the resource exists.

--interval

Polling interval in seconds.

default value: 30
--timeout

Maximum wait in seconds.

default value: 3600
--updated

Wait until updated with provisioningState at 'Succeeded'.