Skip to content

Conversation

@JamesKehr
Copy link

Updated the documentation to specify PowerShell commands for DNS verification and system restart.

nslookup, in Windows, does not use the Windows DNS client resolver. It has an independent resolution engine. The Resolve-DnsName PowerShell cmdlet uses the Windows DNS client resolver.

Resolve-DnsName must be used when testing whether a Windows role, feature, service, or application can correctly resolve a DNS name. Because Resolve-DnsName uses the exact same Win32 API call (DnsQueryEx()) as other Windows processes. While nslookup does not. This can lead to false positive or negative lookups.

Internal to Microsoft, you can read more about this topic at: https://aka.ms/NoNsLookup

Updated the documentation to specify PowerShell commands for DNS verification and system restart.

nslookup, in Windows, does not use the Windows DNS client resolver. It has an independent resolution engine. The Resolve-DnsName PowerShell cmdlet uses the Windows DNS client resolver.

Resolve-DnsName must be used when testing whether a Windows role, feature, service, or application can correctly resolve a DNS name. Because Resolve-DnsName uses the exact same Win32 API calls (DnsQueryEx()) as Windows, while nslookup does not, which can lead to false positive or negative lookups.

Internal to Microsoft, you can read more about this topic at: https://aka.ms/NoNsLookup
Refine DNS setup instructions with PowerShell commands
@prmerger-automator
Copy link
Contributor

@JamesKehr : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change.

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 2c39a14:

✅ Validation status: passed

File Status Preview URL Details
azure-local/deploy/deployment-local-identity-with-key-vault.md ✅Succeeded

For more details, please refer to the build report.

@v-dirichards v-dirichards requested a review from Copilot November 6, 2025 16:29
@v-dirichards
Copy link
Contributor

@alkohli

Can you review the proposed changes?

Important: When the changes are ready for publication, adding a #sign-off comment is the best way to signal that the PR is ready for the review team to merge.

#label:"aq-pr-triaged"
@MicrosoftDocs/public-repo-pr-review-team

@prmerger-automator prmerger-automator bot added the aq-pr-triaged Tracking label for the PR review team label Nov 6, 2025
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR updates DNS configuration documentation to use PowerShell commands instead of legacy cmd commands, aligning the documentation with modern Windows administration practices.

  • Replaced nslookup with Resolve-DnsName PowerShell cmdlet
  • Updated code block language identifiers from cmd to powershell
  • Clarified command type in instructional text

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants