az network dns record-set mx
Manage DNS MX records.
Commands
az network dns record-set mx add-record |
Add an MX record. |
az network dns record-set mx create |
Create an empty MX record set. |
az network dns record-set mx delete |
Delete an MX record set and all associated records. |
az network dns record-set mx list |
List all MX record sets in a zone. |
az network dns record-set mx remove-record |
Remove an MX record from its record set. |
az network dns record-set mx show |
Get the details of an MX record set. |
az network dns record-set mx update |
Update an MX record set. |
az network dns record-set mx add-record
Add an MX record.
az network dns record-set mx add-record --exchange
--preference
--record-set-name
--resource-group
--zone-name
[--if-none-match]
[--subscription]
[--ttl]
Examples
Add an MX record.
az network dns record-set mx add-record -g MyResourceGroup -z www.mysite.com \
-n MyRecordSet -e mail.mysite.com -p 10
Required Parameters
Exchange metric.
Preference metric.
The name of the record set relative to the zone. Creates a new record set if one does not exist.
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
The name of the zone.
Optional Parameters
Create the record set only if it does not already exist.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Record set TTL (time-to-live).
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Increase logging verbosity. Use --debug for full debug logs.
az network dns record-set mx create
Create an empty MX record set.
az network dns record-set mx create --name
--resource-group
--zone-name
[--if-match]
[--if-none-match]
[--metadata]
[--subscription]
[--target-resource]
[--ttl]
Examples
Create an empty MX record set.
az network dns record-set mx create -g MyResourceGroup -z www.mysite.com -n MyRecordSet
Create an empty MX record set. (autogenerated)
az network dns record-set mx create --name MyRecordSet --resource-group MyResourceGroup --ttl 30 --zone-name www.mysite.com
Required Parameters
The name of the record set, relative to the name of the zone.
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
The name of the zone.
Optional Parameters
The etag of the record set. Omit this value to always overwrite the current record set. Specify the last-seen etag value to prevent accidentally overwritting any concurrent changes.
Create the record set only if it does not already exist.
Metadata in space-separated key=value pairs. This overwrites any existing metadata.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
ID of an Azure resource from which the DNS resource value is taken.
Record set TTL (time-to-live).
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Increase logging verbosity. Use --debug for full debug logs.
az network dns record-set mx delete
Delete an MX record set and all associated records.
az network dns record-set mx delete --name
--resource-group
--zone-name
[--if-match]
[--subscription]
[--yes]
Examples
Delete an MX record set and all associated records.
az network dns record-set mx delete -g MyResourceGroup -z www.mysite.com -n MyRecordSet
Required Parameters
The name of the record set, relative to the name of the zone.
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
The name of the zone.
Optional Parameters
The etag of the record set. Omit this value to always delete the current record set. Specify the last-seen etag value to prevent accidentally deleting any concurrent changes.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Do not prompt for confirmation.
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Increase logging verbosity. Use --debug for full debug logs.
az network dns record-set mx list
List all MX record sets in a zone.
az network dns record-set mx list --resource-group
--zone-name
[--query-examples]
[--subscription]
Examples
List all MX record sets in a zone.
az network dns record-set mx list -g MyResourceGroup -z www.mysite.com
List all MX record sets in a zone (autogenerated)
az network dns record-set mx list --resource-group MyResourceGroup --subscription MySubscription --zone-name www.mysite.com
Required Parameters
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
The name of the zone.
Optional Parameters
Recommend JMESPath string for you. You can copy one of the query and paste it after --query parameter within double quotation marks to see the results. You can add one or more positional keywords so that we can give suggestions based on these key words.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Increase logging verbosity. Use --debug for full debug logs.
az network dns record-set mx remove-record
Remove an MX record from its record set.
By default, if the last record in a set is removed, the record set is deleted. To retain the empty record set, include --keep-empty-record-set.
az network dns record-set mx remove-record --exchange
--preference
--record-set-name
--resource-group
--zone-name
[--keep-empty-record-set]
[--subscription]
Examples
Remove an MX record from its record set.
az network dns record-set mx remove-record -g MyResourceGroup -z www.mysite.com \
-n MyRecordSet -e mail.mysite.com -p 10
Required Parameters
Exchange metric.
Preference metric.
The name of the record set relative to the zone.
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
The name of the zone.
Optional Parameters
Keep the empty record set if the last record is removed.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Increase logging verbosity. Use --debug for full debug logs.
az network dns record-set mx show
Get the details of an MX record set.
az network dns record-set mx show --name
--resource-group
--zone-name
[--query-examples]
[--subscription]
Examples
Get the details of an MX record set.
az network dns record-set mx show -g MyResourceGroup -z www.mysite.com -n MyRecordSet
Required Parameters
The name of the record set, relative to the name of the zone.
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
The name of the zone.
Optional Parameters
Recommend JMESPath string for you. You can copy one of the query and paste it after --query parameter within double quotation marks to see the results. You can add one or more positional keywords so that we can give suggestions based on these key words.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Increase logging verbosity. Use --debug for full debug logs.
az network dns record-set mx update
Update an MX record set.
az network dns record-set mx update --name
--resource-group
--zone-name
[--add]
[--force-string]
[--if-match]
[--if-none-match]
[--metadata]
[--remove]
[--set]
[--subscription]
[--target-resource]
Examples
Update an MX record set.
az network dns record-set mx update -g MyResourceGroup -z www.mysite.com \
-n MyRecordSet --metadata owner=WebTeam
Update an MX record set. (autogenerated)
az network dns record-set mx update --name MyRecordSet --resource-group MyResourceGroup --set tags.CostCenter=MyBusinessGroup --zone-name www.mysite.com
Required Parameters
The name of the record set, relative to the name of the zone.
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
The name of the zone.
Optional Parameters
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>.
When using 'set' or 'add', preserve string literals instead of attempting to convert to JSON.
The etag of the record set. Omit this value to always overwrite the current record set. Specify the last-seen etag value to prevent accidentally overwritting any concurrent changes.
Set to '*' to allow a new record set to be created, but to prevent updating an existing record set. Other values will be ignored.
Metadata in space-separated key=value pairs. This overwrites any existing metadata.
Remove a property or an element from a list. Example: --remove property.list OR --remove propertyToRemove.
Update an object by specifying a property path and value to set. Example: --set property1.property2=.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
ID of an Azure resource from which the DNS resource value is taken.
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Increase logging verbosity. Use --debug for full debug logs.