Skip to content

Conversation

@sruthytv1988
Copy link

@sruthytv1988 sruthytv1988 commented Jan 2, 2026

PR Summary

This PR adds documentation for DNS over HTTPS (DoH) configuration cmdlets for Windows Server 2025.

These cmdlets enable administrators to configure encrypted DNS communications using the DoH protocol (RFC 8484), providing enhanced security for DNS queries. The documentation includes comprehensive examples, parameter descriptions, and RFC compliance notes.

This change is planned for public preview and GA.

Cmdlets Added/Updated

  • New: Get-DnsServerEncryptionProtocol - Retrieves DNS over HTTPS encryption settings
  • New: Set-DnsServerEncryptionProtocol - Configures DNS over HTTPS encryption settings

Validation Completed

  • All markdown files pass validation
  • Examples tested and verified on Windows Server 2025
  • Preview disclaimer added to all cmdlets
  • RFC 8484 (DoH) and RFC 3986 (URI) compliance documented
  • Parameter descriptions complete (no placeholders)
  • Cross-references between cmdlets verified
  • Help XML generated and tested locally with Get-Help

Testing Details

  • Tested On: Windows Server 2025 build
  • Verification:
    • Get-Help Get-DnsServerEncryptionProtocol -Full displays all sections correctly
    • Get-Help Set-DnsServerEncryptionProtocol -Examples shows all examples
    • All cmdlet examples execute successfully
    • URI template pipe-separated format works as documented
    • DNS service restart behavior confirmed

@sruthytv1988
Copy link
Author

@sruthytv1988 please read the following Contributor License Agreement(CLA). If you agree with the CLA, please reply with the following information.

@microsoft-github-policy-service agree [company="{your company}"]

Options:

  • (default - no company specified) I have sole ownership of intellectual property rights to my Submissions and I am not making Submissions in the course of work for my employer.
@microsoft-github-policy-service agree
  • (when company given) I am making Submissions in the course of work for my employer (or my employer has intellectual property rights in my Submissions by contract or applicable law). I have permission from my employer to make Submissions and enter into this Agreement on behalf of my employer. By signing below, the defined term “You” includes me and my employer.
@microsoft-github-policy-service agree company="Microsoft"

Contributor License Agreement

@learn-build-service-prod
Copy link
Contributor

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@sruthytv1988
Copy link
Author

@sruthytv1988 please read the following Contributor License Agreement(CLA). If you agree with the CLA, please reply with the following information.

@microsoft-github-policy-service agree [company="{your company}"]

Options:

  • (default - no company specified) I have sole ownership of intellectual property rights to my Submissions and I am not making Submissions in the course of work for my employer.
@microsoft-github-policy-service agree
  • (when company given) I am making Submissions in the course of work for my employer (or my employer has intellectual property rights in my Submissions by contract or applicable law). I have permission from my employer to make Submissions and enter into this Agreement on behalf of my employer. By signing below, the defined term “You” includes me and my employer.
@microsoft-github-policy-service agree company="Microsoft"

Contributor License Agreement

@microsoft-github-policy-service agree company="Microsoft"

@sruthytv1988
Copy link
Author

@microsoft-github-policy-service agree company="Microsoft"

@sruthytv1988 sruthytv1988 reopened this Jan 2, 2026
@learn-build-service-prod
Copy link
Contributor

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit dca945c:

⚠️ Validation status: warnings

File Status Preview URL Details
docset/winserver2025-ps/DnsServer/DnsServer.md ⚠️Warning View (WindowsServer2025-ps) Details
docset/winserver2025-ps/DnsServer/Get-DnsServerEncryptionProtocol.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DnsServer/Set-DnsServerEncryptionProtocol.md ✅Succeeded View (WindowsServer2025-ps)

docset/winserver2025-ps/DnsServer/DnsServer.md

  • Line 0, Column 0: [Warning: PSMD2Yaml_InconsistentCmdletsInModule] Inconsistent cmdlets found in module: DnsServer. 2 cmdlets in the module folder but not listed in the module file: Get-DnsServerEncryptionProtocol, Set-DnsServerEncryptionProtocol.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit dca945c:

⚠️ Validation status: warnings

File Status Preview URL Details
docset/winserver2025-ps/DnsServer/DnsServer.md ⚠️Warning View (WindowsServer2025-ps) Details
docset/winserver2025-ps/DnsServer/Get-DnsServerEncryptionProtocol.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DnsServer/Set-DnsServerEncryptionProtocol.md ✅Succeeded View (WindowsServer2025-ps)

docset/winserver2025-ps/DnsServer/DnsServer.md

  • Line 0, Column 0: [Warning: PSMD2Yaml_InconsistentCmdletsInModule] Inconsistent cmdlets found in module: DnsServer. 2 cmdlets in the module folder but not listed in the module file: Get-DnsServerEncryptionProtocol, Set-DnsServerEncryptionProtocol.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

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.

2 participants