Skip to content

Populate Delivery Optimization cmdlet descriptions - #4150

Merged
Robin Harwood (robinharwood) merged 5 commits into
MicrosoftDocs:mainfrom
cmknox:main
Nov 19, 2026
Merged

Robin Harwood (robinharwood) merged 5 commits into
MicrosoftDocs:mainfrom
cmknox:main

Conversation

@cmknox

Copy link
Copy Markdown
Contributor

Replace placeholder text in the Delivery Optimization module overview with descriptions for all 18 cmdlets and a module summary.

Descriptions are based on Microsoft Learn documentation and clarify download monitoring, bandwidth configuration, cache management, and logging. Individual cmdlet pages are unchanged.

Carmen Forsmann and others added 2 commits November 2, 2026 16:18
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Document all 18 cmdlets, including parameters, examples, inputs, outputs, and operational notes.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@learn-build-service-prod

Copy link
Copy Markdown
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
Copy Markdown
Contributor

Learn Build status updates of commit f9feebc:

✅ Validation status: passed

File Status Preview URL Details
docset/winserver2025-ps/DeliveryOptimization/Delete-DeliveryOptimizationCache.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/DeliveryOptimization.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Disable-DeliveryOptimizationVerboseLogs.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Enable-DeliveryOptimizationVerboseLogs.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Get-DeliveryOptimizationLog.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Get-DeliveryOptimizationLogAnalysis.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Get-DeliveryOptimizationPerfSnap.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Get-DeliveryOptimizationPerfSnapThisMonth.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Get-DeliveryOptimizationStatus.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Get-DOConfig.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Get-DODownloadMode.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Get-DOPercentageMaxBackgroundBandwidth.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Get-DOPercentageMaxForegroundBandwidth.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Set-DeliveryOptimizationStatus.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Set-DODownloadMode.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Set-DOMaxBackgroundBandwidth.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Set-DOMaxForegroundBandwidth.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Set-DOPercentageMaxBackgroundBandwidth.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Set-DOPercentageMaxForegroundBandwidth.md ✅Succeeded View (WindowsServer2025-ps)

For more details, please refer to the build report.

@learn-build-service-prod

Copy link
Copy Markdown
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
Copy Markdown
Contributor

Learn Build status updates of commit e75e383:

✅ Validation status: passed

File Status Preview URL Details
docset/winserver2025-ps/DeliveryOptimization/Delete-DeliveryOptimizationCache.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/DeliveryOptimization.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Disable-DeliveryOptimizationVerboseLogs.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Enable-DeliveryOptimizationVerboseLogs.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Get-DeliveryOptimizationLog.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Get-DeliveryOptimizationLogAnalysis.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Get-DeliveryOptimizationPerfSnap.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Get-DeliveryOptimizationPerfSnapThisMonth.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Get-DeliveryOptimizationStatus.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Get-DOConfig.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Get-DODownloadMode.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Get-DOPercentageMaxBackgroundBandwidth.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Get-DOPercentageMaxForegroundBandwidth.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Set-DeliveryOptimizationStatus.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Set-DODownloadMode.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Set-DOMaxBackgroundBandwidth.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Set-DOMaxForegroundBandwidth.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Set-DOPercentageMaxBackgroundBandwidth.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Set-DOPercentageMaxForegroundBandwidth.md ✅Succeeded View (WindowsServer2025-ps)

For more details, please refer to the build report.

@learn-build-service-prod

Copy link
Copy Markdown
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
Copy Markdown
Contributor

Learn Build status updates of commit c41ff9e:

✅ Validation status: passed

File Status Preview URL Details
docset/winserver2025-ps/DeliveryOptimization/Delete-DeliveryOptimizationCache.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/DeliveryOptimization.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Disable-DeliveryOptimizationVerboseLogs.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Enable-DeliveryOptimizationVerboseLogs.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Get-DeliveryOptimizationLog.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Get-DeliveryOptimizationLogAnalysis.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Get-DeliveryOptimizationPerfSnap.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Get-DeliveryOptimizationPerfSnapThisMonth.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Get-DeliveryOptimizationStatus.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Get-DOConfig.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Get-DODownloadMode.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Get-DOPercentageMaxBackgroundBandwidth.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Get-DOPercentageMaxForegroundBandwidth.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Set-DeliveryOptimizationStatus.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Set-DODownloadMode.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Set-DOMaxBackgroundBandwidth.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Set-DOMaxForegroundBandwidth.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Set-DOPercentageMaxBackgroundBandwidth.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Set-DOPercentageMaxForegroundBandwidth.md ✅Succeeded View (WindowsServer2025-ps)

For more details, please refer to the build report.

@robinharwood Robin Harwood (robinharwood) left a comment •

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Learn - PR Reviewer (Preview)

PR: MicrosoftDocs/windows-powershell-docs#4150

Summary: 0 errors; 7 warnings; 31 suggestions, with related style suggestions grouped by article.

Coverage: Incomplete. All 18 cmdlet articles received specialist technical review. Writing-style checks
covered changed prose in all 19 articles, including the module overview.

Scope of authority: The writing-style review evaluated style, voice, and tone only, not
technical correctness. Technical observations below remain subject to maintainer confirmation for
the intended product build. Writing-style suggestions are optional editorial improvements.

Reviewed head: c41ff9e.

Errors

Severity Rule (file:line) Source Finding Recommended action
None Not applicable Not applicable No error-level findings. None.

Warnings

Severity Rule (file:line) Source Finding Recommended action
Warning Connection output: Get-DeliveryOptimizationLogAnalysis.md:76 PowerShell reference ListConnections writes connection details to the verbose stream; it does not replace the summary object. The example omits -Verbose. Contributor: Correct the parameter description and example; distinguish the summary object from verbose connection details.
Warning Flush behavior: Get-DeliveryOptimizationLog.md:31 PowerShell reference The service-stop claim conflicts with the inspected flush operation. Contributor: Confirm build applicability, then remove the service-stop and associated interruption claims from the description, parameter guidance, and example.
Warning Flush behavior: Get-DeliveryOptimizationLogAnalysis.md:33 PowerShell reference The analysis article repeats the service-stop claim. Contributor: Confirm build applicability and correct both the description and Flush parameter guidance.
Warning Pipeline behavior: Get-DeliveryOptimizationLog.md:100 PowerShell reference Files are read before pipeline records are processed. Declared pipeline binding does not establish that piped paths select the files read. Contributor: Document explicit Path arguments and the pipeline limitation; refer the implementation mismatch to the maintainer.
Warning Pipeline behavior: Get-DeliveryOptimizationLogAnalysis.md:94 PowerShell reference Analysis likewise reads files before processing pipeline records, contradicting the added pipeline guidance. Contributor: Tell readers to pass paths directly to Path and reconcile the binding contract with the maintainer.
Warning Expiration boundary: Set-DeliveryOptimizationStatus.md:69 PowerShell reference "Less than one year" does not express the verified fixed 365-day upper boundary precisely. A future-only lower boundary remains unconfirmed. Contributor: Use "less than 365 days" for the upper limit; confirm lower-bound behavior before asserting it.
Warning Partial completion: Set-DeliveryOptimizationStatus.md:35 PowerShell reference A combined Pin/ExpireOn request can change pinning before a later expiration failure, without rollback. Contributor: Explain the operation order and possible partial completion alongside the combined-operation guidance.

Suggestions

Severity Rule (file:line) Source Finding Recommended action
Suggestion Restart exception: Disable-DeliveryOptimizationVerboseLogs.md:27 PowerShell reference If verbose tracing configuration is absent, the command exits without restarting, even with Force. Contributor: Add the already-disabled exception to qualify the description and examples.
Suggestion Explicit parameter: Get-DeliveryOptimizationPerfSnap.md:45 PowerShell reference Select-Object uses a positional Property argument. Contributor: Add -Property; retain the existing property names.
Suggestion Explicit parameter: Get-DeliveryOptimizationPerfSnapThisMonth.md:45 PowerShell reference The monthly example also uses a positional Property argument. Contributor: Add -Property; retain all four existing property names.
Suggestion Active voice and simple words: Delete-DeliveryOptimizationCache.md:26, 50, 129 Writing Style Three optional improvements: "pinned files aren't deleted"; "FileId returned by"; "displays deletion status". Contributor: Consider "the cmdlet doesn't delete pinned files", "FileId that Get-DeliveryOptimizationStatus returns", and "shows deletion status".
Suggestion Active voice and simple words: Disable-DeliveryOptimizationVerboseLogs.md:25, 86 Writing Style Two optional improvements: "overrides set by" and "displays logging configuration status". Contributor: Consider "overrides that Enable-DeliveryOptimizationVerboseLogs sets" and "shows logging configuration status".
Suggestion Simple words: Enable-DeliveryOptimizationVerboseLogs.md:88 Writing Style "Displays" is more formal than necessary here. Contributor: Consider "shows logging configuration status".
Suggestion Conciseness and active voice: Get-DOConfig.md:48, 73 Writing Style Two optional improvements: "in addition to the basic configuration" and "when verbose output is enabled". Contributor: Consider "returns the basic configuration and extended configuration values" and "when you enable verbose output".
Suggestion Active voice and acronym clarity: Get-DODownloadMode.md:64, 65 Writing Style Three optional improvements: actor-led descriptions of reported/configured modes and expansion of MDM. Contributor: Consider "This cmdlet can report modes even if Set-DODownloadMode doesn't accept them" and "You can also configure a mode through Group Policy or mobile device management."
Suggestion Active voice: Get-DOPercentageMaxBackgroundBandwidth.md:64 Writing Style "The bandwidth used by downloads" can use an active clause. Contributor: Consider "how much bandwidth downloads use".
Suggestion Active voice: Get-DOPercentageMaxForegroundBandwidth.md:64 Writing Style The foreground article has the same reduced-passive construction. Contributor: Consider "the bandwidth that downloads use".
Suggestion Simple words: Get-DeliveryOptimizationPerfSnap.md:48 Writing Style The example explanation uses "displays". Contributor: Consider "shows"; preserve the metric descriptions.
Suggestion Simple words: Get-DeliveryOptimizationPerfSnapThisMonth.md:48 Writing Style The monthly example explanation also uses "displays". Contributor: Consider "shows"; preserve the reporting-period and source descriptions.
Suggestion Active voice and acronym clarity: Set-DODownloadMode.md:28 Writing Style Two optional improvements: undefined MDM and "changes made with this cmdlet". Contributor: Expand MDM and consider "changes you make with this cmdlet".
Suggestion Acronym clarity and terminology: Set-DOMaxBackgroundBandwidth.md:30 Writing Style Two optional improvements: undefined MDM and instrumental "with". Contributor: Consider "Group Policy or mobile device management (MDM) policy can override changes made by using this cmdlet."
Suggestion Active voice and acronym clarity: Set-DOMaxForegroundBandwidth.md:30, 48 Writing Style Three optional improvements: undefined MDM, "changes made", and "the limit set by this cmdlet". Contributor: Expand MDM and consider "changes this cmdlet makes" and "the limit this cmdlet sets".
Suggestion Active voice: Set-DOPercentageMaxBackgroundBandwidth.md:31 Writing Style "Changes made with this cmdlet" can name the actor. Contributor: Consider "changes you make with this cmdlet".
Suggestion Active voice and acronym clarity: Set-DOPercentageMaxForegroundBandwidth.md:31 Writing Style Two optional improvements: undefined MDM and "changes made". Contributor: Expand MDM and consider "changes this cmdlet makes".
Suggestion Active voice and simple words: Set-DeliveryOptimizationStatus.md:29, 31-32, 137 Writing Style Three optional improvements: passive expiration/retention descriptions and "displays update status". Contributor: Consider "the expiration takes effect after the download completes", "Delivery Optimization retains pinned files ... and excludes them ...", and "shows update status".

Writing-style outcome: No broad voice or tone problem was found. The prose is generally direct,
neutral, and suitable for command reference. Style suggestions are low priority and do not establish
technical authority. The module overview and job-status article had no writing-style findings.

Conflict handling: Seven style-only recommendations targeted Flush or pipeline statements already
identified for technical correction. They are superseded, not offered as edits that would polish and
retain disputed guidance. Preserve technical meaning and required PowerShell help structure when
applying any remaining style suggestion.

No article edits have been made.

@learn-build-service-prod

Copy link
Copy Markdown
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
Copy Markdown
Contributor

Learn Build status updates of commit c3d6b66:

✅ Validation status: passed

File Status Preview URL Details
docset/winserver2025-ps/DeliveryOptimization/Delete-DeliveryOptimizationCache.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/DeliveryOptimization.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Disable-DeliveryOptimizationVerboseLogs.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Enable-DeliveryOptimizationVerboseLogs.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Get-DeliveryOptimizationLog.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Get-DeliveryOptimizationLogAnalysis.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Get-DeliveryOptimizationPerfSnap.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Get-DeliveryOptimizationPerfSnapThisMonth.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Get-DeliveryOptimizationStatus.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Get-DOConfig.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Get-DODownloadMode.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Get-DOPercentageMaxBackgroundBandwidth.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Get-DOPercentageMaxForegroundBandwidth.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Set-DeliveryOptimizationStatus.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Set-DODownloadMode.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Set-DOMaxBackgroundBandwidth.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Set-DOMaxForegroundBandwidth.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Set-DOPercentageMaxBackgroundBandwidth.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/DeliveryOptimization/Set-DOPercentageMaxForegroundBandwidth.md ✅Succeeded View (WindowsServer2025-ps)

For more details, please refer to the build report.

@robinharwood
Robin Harwood (robinharwood) merged commit 8fc3941 into MicrosoftDocs:main Nov 19, 2026
9 checks passed
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