Skip to content

Document AI runtime protection and prompt evidence PowerShell preferences - #4154

Open
Josh Bregman (j0shbregman) wants to merge 5 commits into
MicrosoftDocs:mainfrom
j0shbregman:docs/ai-runtime-prompt-evidence-20261111
Open

Josh Bregman (j0shbregman) wants to merge 5 commits into
MicrosoftDocs:mainfrom
j0shbregman:docs/ai-runtime-prompt-evidence-20261111

Conversation

@j0shbregman

@j0shbregman Josh Bregman (j0shbregman) commented Nov 11, 2026 •

Copy link
Copy Markdown

Summary

Document the AI agent runtime protection and prompt evidence collection preferences in the latest Defender PowerShell reference.

  • Add AiAgentProtection, AiAgentNetworkInspection, and PromptEvidenceCollection to Set-MpPreference and the corresponding reset switches to Remove-MpPreference.
  • Add examples for audit mode, optional prompt evidence collection, preference inspection, and local preference removal.
  • Explain the device default changing from Off to On through an update to the November 2026 platform release, the audit/block prerequisite, managed-policy precedence, privacy considerations, and the distinction between collection and evidence for blocked activity. Earlier builds retain the Off default; explicit settings take precedence.
  • Link to the runtime protection setup guide for prerequisites and deployment guidance. These additions describe the supported Windows client preview; they do not extend runtime protection support to Windows Server.

Validation

Compared parameter types, aliases, and enum names with native Windows PowerShell cmdlet metadata. Parsed examples without executing configuration changes. Checked whitespace, parameter headings, and documentation links.

  • Descriptive title and change summary
  • Contributor guidance reviewed
  • Changes follow the existing reference structure and formatting

November default transition: publication gate

Confirm the exact first Microsoft Defender Antivirus platform version containing the default-On change before publication, and use that minimum version in the reference. The current wording identifies the November 2026 release update without assuming every November build contains the change. Enabling collection does not enable runtime protection or change its audit or block mode. Parameter syntax, types, and aliases are unchanged.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 6adf5eb1-896a-452e-b844-20fca8e9801a
@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 90b4917:

✅ Validation status: passed

File Status Preview URL Details
docset/winserver2025-ps/Defender/Get-MpPreference.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/Defender/Remove-MpPreference.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/Defender/Set-MpPreference.md ✅Succeeded View (WindowsServer2025-ps)

For more details, please refer to the build report.

…site

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 6adf5eb1-896a-452e-b844-20fca8e9801a
@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 f981695:

✅ Validation status: passed

File Status Preview URL Details
docset/winserver2025-ps/Defender/Get-MpPreference.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/Defender/Remove-MpPreference.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/Defender/Set-MpPreference.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 6df3501:

✅ Validation status: passed

File Status Preview URL Details
docset/winserver2025-ps/Defender/Get-MpPreference.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/Defender/Remove-MpPreference.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/Defender/Set-MpPreference.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 cfc3642:

✅ Validation status: passed

File Status Preview URL Details
docset/winserver2025-ps/Defender/Get-MpPreference.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/Defender/Remove-MpPreference.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/Defender/Set-MpPreference.md ✅Succeeded View (WindowsServer2025-ps)

For more details, please refer to the build report.

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: #4154
Reviewed head: cfc3642c52460feeee4f73ef446efa4f0cbd0cc3
Summary: 1 blocking issue · 1 publication gate · 2 optional suggestions

⛔ Blocking

[P2] Missing prompt-evidence privacy guidance

Locations: Set-MpPreference.md:140, Set-MpPreference.md:1317, Remove-MpPreference.md:1050

Original:

[Configure prompt evidence collection](/defender-endpoint/configure-ai-agent-runtime-protection#configure-prompt-evidence-collection)

The destination article has no matching section or collection-specific privacy guidance. Readers are instructed to review this guidance before enabling sensitive-data collection but cannot find it.

Recommended action: Publish the referenced section or replace all three links with verified privacy guidance before publication.

🚧 Publication gate

Confirm the first platform version containing the default-On change

Location: Set-MpPreference.md:1301–1304

Original:

The default is changing from Off to On through an update to the November 2026 Microsoft Defender Antivirus platform release.

The PR body explicitly requires confirmation of the first platform version containing this change.

Recommended action: Obtain the confirmed first version and document that boundary. Preserve earlier-build Off behavior, explicit-setting precedence, and the distinction that not every November build contains the update.

💡 Optional voice-and-tone suggestions

No required corrections were identified.

Location Original Suggested
Get-MpPreference.md, Example 2 “The properties require supported Microsoft Defender Antivirus platform and engine updates.” “These properties require supported Microsoft Defender Antivirus platform and engine updates.”
Set-MpPreference.md:1294 “When collection is enabled and runtime protection is enabled in audit or block mode” “When prompt evidence collection is enabled and runtime protection is in audit or block mode”

Review status: Open pending the missing guidance and version confirmation.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 6adf5eb1-896a-452e-b844-20fca8e9801a
@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 2405857:

✅ Validation status: passed

File Status Preview URL Details
docset/winserver2025-ps/Defender/Get-MpPreference.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/Defender/Remove-MpPreference.md ✅Succeeded View (WindowsServer2025-ps)
docset/winserver2025-ps/Defender/Set-MpPreference.md ✅Succeeded View (WindowsServer2025-ps)

For more details, please refer to the build report.

@j0shbregman

Copy link
Copy Markdown
Author

Robin Harwood (@robinharwood) The prompt-evidence guidance flagged in the review is now published on Microsoft Learn:

  • Configure prompt evidence collection — the exact destination referenced by this PR now exists, with prerequisites, enable/disable/remove commands, and managed-policy precedence. It links directly to the overview for feature defaults and privacy guidance.
  • Prompt evidence collection: behavior, defaults, and privacy — explains the suspicious prompt/response snippets collected, redaction and residual sensitivity, organizational privacy review, Defender XDR retention, and the distinction between device-level collection and evidence associated with blocked activity.

This addresses the missing-section/privacy-guidance concern. Both pages are live public documentation, not PR preview links.

The separate publication gate for the exact first Defender Antivirus platform version containing the default-On change remains open. The live overview describes an upcoming platform release without claiming a confirmed version or November build boundary. This reply does not supply that confirmation or assert that all review concerns are resolved.

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