From 5eadbc9f176a621d51f282ce739d0290bf625d7e Mon Sep 17 00:00:00 2001 From: James Kehr <40303902+JamesKehr@users.noreply.github.com> Date: Thu, 6 Nov 2025 11:09:18 -0500 Subject: [PATCH] Refine DNS setup instructions with PowerShell commands 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 --- .../deployment-local-identity-with-key-vault.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/azure-local/deploy/deployment-local-identity-with-key-vault.md b/azure-local/deploy/deployment-local-identity-with-key-vault.md index a71724a887..9e1d67686d 100644 --- a/azure-local/deploy/deployment-local-identity-with-key-vault.md +++ b/azure-local/deploy/deployment-local-identity-with-key-vault.md @@ -70,10 +70,10 @@ Follow these steps to configure DNS for Azure Local: 1. **Verify DNS records.** - To verify that the DNS records for a specific machine are correctly set up, run the following command: + To verify that the DNS records for a specific machine are correctly set up, run the following PowerShell command: - ```cmd - nslookup "machine name" + ```powershell + Resolve-DnsName "" ``` 1. **Set up DNS forwarding.** @@ -86,11 +86,11 @@ Follow these steps to configure DNS for Azure Local: 1. **Verify DNS configuration.** - Test the DNS configuration to ensure that DNS queries are resolved correctly. You can use tools like `nslookup` or dig to verify DNS resolution. + Test the DNS configuration to ensure that DNS queries are resolved correctly. You can use tools like `Resolve-DnsName` in Windows PowerShell or dig to verify DNS resolution. -1. Restart the operating system on local and remote machines using the following command: +1. Restart the operating system on local and remote machines using the following PowerShell command: - ```cmd + ```powershell Restart-Computer ```