New DNS Forwarding Ruleset Rule Examples are incomplete

[mundayn]

Type of issue

Missing information

Feedback

Hi all,

This documentation is unclear and hard to follow.

Please see this page that provides a very clear example on how to use "New-AzDnsForwardingRulesetForwardingRule":
https://learn.microsoft.com/en-us/azure/dns/dns-private-resolver-get-started-powershell#create-forwarding-rules

The page in question does not show you how to add a "DomainName" value for the rule, which is the a core part of the rule.

The "$targetIPConfig" also does not make any sense to me to why it is needed. I have a feeling this is an error, and it should be "New-AzDnsResolverTargetDnsServerObject", and not "New-AzDnsResolverIPConfigurationObject".

Page URL

https://learn.microsoft.com/en-us/powershell/module/az.dnsresolver/new-azdnsforwardingrulesetforwardingrule?view=azps-11.5.0

Content source URL

https://github.com/Azure/azure-powershell/blob/main/src/DnsResolver/DnsResolver/help/New-AzDnsForwardingRulesetForwardingRule.md

Author

@mikefrobbins

Document Id

66bb54a2-a30b-8869-f36b-6949baef5627

[isra-fel]

Thanks for reporting. Let me loop in DNS team to follow up.

[argagnej]

Checked the latest doc, https://learn.microsoft.com/en-us/azure/dns/dns-private-resolver-get-started-powershell#create-forwarding-rules, and it does have the information on how to add a domain name.

[mundayn]

Checked the latest doc, https://learn.microsoft.com/en-us/azure/dns/dns-private-resolver-get-started-powershell#create-forwarding-rules, and it does have the information on how to add a domain name.

Hi

The quickstart page does advise, but the official documentation page for the cmdlet does not.

Page in questions:
https://learn.microsoft.com/en-us/powershell/module/az.dnsresolver/new-azdnsforwardingrulesetforwardingrule?view=azps-15.1.0&viewFallbackFrom=azps-11.5.0

[argagnej]

Thanks @mundayn for bringing this to our attention. We will fix the documentation.