Skip to content

Document WDS image import administrator requirement - #4145

Draft
Robin Harwood (robinharwood) wants to merge 3 commits into
MicrosoftDocs:mainfrom
robinharwood:roharwoo/639834-wds-import-admin
Draft

Robin Harwood (robinharwood) wants to merge 3 commits into
MicrosoftDocs:mainfrom
robinharwood:roharwoo/639834-wds-import-admin

Conversation

@robinharwood

@robinharwood Robin Harwood (robinharwood) commented Oct 22, 2026 •

Copy link
Copy Markdown
Collaborator

PR Summary

Document the administrator requirement for Import-WdsInstallImage after the
2026-11 security update across all four reference versions in this repository:
Windows Server 2016, 2019, 2022, and 2025.

  • Add a TIP at the start of DESCRIPTION explaining that import attempts by users
    without administrator privileges fail with ACCESS_DENIED.
  • Direct readers to use an account with administrator privileges while retaining
    all other cmdlet requirements.
  • Update ms.date; preserve the synopsis, syntax, parameters, examples, and legacy
    PlatyPS schema.
  • Include applicable Windows client reference coverage through the existing shared
    docsets. Repository-wide discovery found exactly four copies of this cmdlet page;
    there is no separate Windows client copy. The publishing configuration assigns
    Windows client product metadata to these docsets.
  • Applicability was confirmed by the contributor on October 22, 2026. Per the
    clarified scope, this PR covers only reference versions present in this repository;
    it does not add or modify archived Windows Server 2012 or 2012 R2 pages.

Tracking: Content work item 639834.

Draft: do not merge or publish yet.

  • Version applicability is confirmed; technical approval of the final wording and
    approved public update wording remain pending.
  • Confirm any KB reference rather than adding an unverified identifier.
  • Coordinate publication with the confirmed November 2026 security update release
    gate (planned for November 10, 2026).

Validation:

  • git -C C:\gitclones\windows-powershell-docs-639834 diff --check - passed.
  • MOSAIC global and local writing-style review of the added wording - passed;
    local style and Markdown review of the final DESCRIPTION TIP - passed.
  • Reused that exact reviewed TIP unchanged in the three additional versions.
  • Static inspection preserved the existing PlatyPS headings and protected content.
  • No executable PlatyPS, MAML, or rendered-site validation was run locally.
    Repository build validation remains pending.
  • The pre-existing empty INPUTS section is unchanged and outside this PR's scope.

PR Checklist

  • Descriptive Title: This PR's title is a synopsis of the changes it proposes.
  • Summary: This PR's summary describes the scope and intent of the change.
  • Contributor's Guide: I have read the contributors guide.
  • Style: This PR adheres to the style guide.

Add a provisional Windows Server 2025 permissions TIP for the 2026-11 security update.

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 5a76968:

✅ Validation status: passed

File Status Preview URL Details
docset/winserver2025-ps/WDS/Import-WdsInstallImage.md ✅Succeeded View (WindowsServer2025-ps)

For more details, please refer to the build report.

Apply the reviewed TIP to the 2016, 2019, and 2022 docsets following applicability confirmation.

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 1184fd9:

✅ Validation status: passed

File Status Preview URL Details
docset/winserver2016-ps/WDS/Import-WdsInstallImage.md ✅Succeeded View (WindowsServer2016-ps)
docset/winserver2019-ps/WDS/Import-WdsInstallImage.md ✅Succeeded View (WindowsServer2019-ps)
docset/winserver2022-ps/WDS/Import-WdsInstallImage.md ✅Succeeded View (WindowsServer2022-ps)
docset/winserver2025-ps/WDS/Import-WdsInstallImage.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 aaf535e:

✅ Validation status: passed

File Status Preview URL Details
docset/winserver2016-ps/WDS/Import-WdsInstallImage.md ✅Succeeded View (WindowsServer2016-ps)
docset/winserver2019-ps/WDS/Import-WdsInstallImage.md ✅Succeeded View (WindowsServer2019-ps)
docset/winserver2022-ps/WDS/Import-WdsInstallImage.md ✅Succeeded View (WindowsServer2022-ps)
docset/winserver2025-ps/WDS/Import-WdsInstallImage.md ✅Succeeded View (WindowsServer2025-ps)

For more details, please refer to the build report.

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.

1 participant