Update File Archive Policy cmdlets for OneDrive support

[HectorRMota]

Summary

Updates the File Archive Policy cmdlet reference to cover OneDrive for Business support and the site exclusion model, and corrects the guidance for the file type criteria parameters.

These cmdlets were first documented in #1181. This PR reflects subsequent changes to the cmdlet surface.

Changes

Add-SPOSiteToFileArchivePolicy

• Documents the new -Exclude switch.
• Explains the two modes: inclusions are only valid for a SelectedSites policy, exclusions only for an AllSites or AllODBSites policy. Using the wrong one returns an error.
• Adds an exclusion example and notes the 1,000 site per policy limit.

New-SPOFileArchivePolicy and Set-SPOFileArchivePolicy

• Adds AllODBSites to the accepted values for -PolicyType, for policies that target all OneDrive for Business sites in the tenant.
• Documents the new -FileTypeExclusionCriteria parameter.
• Set-SPOFileArchivePolicy: corrects the activation rule, which also applies to AllODBSites.

Get-SPOFileArchivePolicySites

• Clarifies that the returned list is the included sites for a SelectedSites policy, and the excluded sites for an AllSites or AllODBSites policy.

Remove-SPOSiteToFileArchivePolicy

• Clarifies that it removes either an inclusion or an exclusion, and documents the guard that prevents removing the last site from an active SelectedSites policy.

Corrects a published error

The existing New-SPOFileArchivePolicy Example 2 passes -FileTypeCriteria:

New-SPOFileArchivePolicy -PolicyType "SelectedSites" -Name "ArchiveMarketing" -LastAccessDateCriteria 12 -FileTypeCriteria ".docx", ".pptx", ".xlsx"

File type filtering is not implemented in the current preview, and the service rejects any non-null value for this parameter with "Updating file type criteria is not supported." The example as published would fail for anyone who ran it, so it has been replaced with one that works.

Both -FileTypeCriteria and -FileTypeExclusionCriteria are now documented with a note describing the current behavior, so the newly added parameter isn't presented as functional either.

Notes for reviewers

• The feature is in preview and gated behind a rollout flight, so none of this is customer-visible yet. Every affected topic already carries the existing preview note.
• No new topics are added and no files are renamed; all changes are to the five existing File Archive Policy topics. The module landing page needs no update, since the cmdlet summaries are unchanged.

[learn-build-service-prod]

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]

Learn Build status updates of commit 832c31d:

✅ Validation status: passed

File	Status	Preview URL	Details
sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Add-SPOSiteToFileArchivePolicy.md	✅Succeeded	View (sharepoint-ps)
sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOFileArchivePolicySites.md	✅Succeeded	View (sharepoint-ps)
sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOFileArchivePolicy.md	✅Succeeded	View (sharepoint-ps)
sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Remove-SPOSiteToFileArchivePolicy.md	✅Succeeded	View (sharepoint-ps)
sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOFileArchivePolicy.md	✅Succeeded	View (sharepoint-ps)

For more details, please refer to the build report.

[github-actions]

sachin-lalwani
You've been added as a reviewer to this pull request because you're listed as a Content Lead for the product area or feature covered by one or more articles in this PR.

Before this PR can be merged, a Content Lead needs to add the Sign off label to it. Only one of the listed reviewers needs to add the Sign off label. Before you sign off a PR, confirm the following:

• The PR is not in draft state. When the changes in this PR are ready to be published, select the Ready to merge button at the bottom of the page.
• Article content has been checked for technical accuracy.
• There are no errors or warnings in build validation.
• There are no severity 1 or 2 PoliCheck issues.
• All required PR checks at the bottom of the PR are passing.

After you've confirmed the above, do the following to sign off:

1. Select the gear next to Labels.
2. Select Sign off from the label list.
3. Click away from the label list.

After you've signed off, our operations (PubOps) team will review the PR for issues that may impact formatting and the customer experience. If any changes are needed, they will return
the PR to the submitter with required changes. After they've completed those changes, you need to sign off again.

When the PR passes PubOps review, they'll merge the PR. If the PR is merged into the main branch, changes will go live within the next couple hours.

If you think you were incorrectly added as a reviewer, have questions about this process, or need help signing off on this PR, post a message to https://aka.ms/tcphelp.

[Sam M. Kabue (samkabue-msft)]

I'd prefer this is implemented in backend so we avoid this note altogether

[HectorRMota]

Agreed - removing note and this will be handled in the back end

[Sam M. Kabue (samkabue-msft)]

🕐

[learn-build-service-prod]

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]

Learn Build status updates of commit ff37af9:

✅ Validation status: passed

File	Status	Preview URL	Details
sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Add-SPOSiteToFileArchivePolicy.md	✅Succeeded	View (sharepoint-ps)
sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOFileArchivePolicySites.md	✅Succeeded	View (sharepoint-ps)
sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOFileArchivePolicy.md	✅Succeeded	View (sharepoint-ps)
sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Remove-SPOSiteToFileArchivePolicy.md	✅Succeeded	View (sharepoint-ps)
sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOFileArchivePolicy.md	✅Succeeded	View (sharepoint-ps)

For more details, please refer to the build report.

[Sam M. Kabue (samkabue-msft)]

[learn-build-service-prod]

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]

Learn Build status updates of commit 42c63e7:

✅ Validation status: passed

File	Status	Preview URL	Details
sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Add-SPOSiteToFileArchivePolicy.md	✅Succeeded	View (sharepoint-ps)
sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOFileArchivePolicySites.md	✅Succeeded	View (sharepoint-ps)
sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOFileArchivePolicy.md	✅Succeeded	View (sharepoint-ps)
sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Remove-SPOSiteToFileArchivePolicy.md	✅Succeeded	View (sharepoint-ps)
sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOFileArchivePolicy.md	✅Succeeded	View (sharepoint-ps)

For more details, please refer to the build report.