Configure Microsoft 365 Files to Open in Desktop Apps by Default
Question details
Administrators are trying to set Microsoft 365 files to open in desktop client applications by default tenant-wide, but the required parameter in PowerShell is unavailable.

- Product
- Microsoft 365
- Device & OS
- not provided
- Scenario
- Configuring global tenant settings to enforce opening Office files in desktop applications rather than the web browser.
- Observed behavior
- Running the Set-SPOTenant -DefaultOneDriveOpenBehavior command returns an error indicating the parameter is not found, due to an outdated SharePoint Online Management Shell module.
Ensure you have SharePoint Administrator privileges in your Microsoft 365 tenant and that you are running PowerShell as an administrator.
Update SharePoint Online Management Shell and Apply Tenant Setting
The missing parameter issue is caused by an outdated PowerShell module. Updating to the latest version resolves this and allows tenant-wide configuration.
The -DefaultOneDriveOpenBehavior parameter was introduced in newer versions of the Microsoft.Online.SharePoint.PowerShell module. If you are running an older version (like 16.0.25409.12000), you must uninstall it and install the latest release.
Right-click the Start button and select 'Windows PowerShell (Admin)' or 'Windows Terminal (Admin)'.
Run the command: Uninstall-Module -Name Microsoft.Online.SharePoint.PowerShell -AllVersions -Force
Run the command: Install-Module -Name Microsoft.Online.SharePoint.PowerShell -Force
Run the command: Connect-SPOService -Url https://[yourtenant]-admin.sharepoint.com, replacing [yourtenant] with your actual Microsoft 365 tenant name.
Run the command: Set-SPOTenant -DefaultOneDriveOpenBehavior OpenInClient

Configure Open Behavior at the Document Library Level
If tenant-wide configuration via PowerShell is not feasible or fails, you can configure individual SharePoint document libraries to open files in desktop apps.
Try WPS Office for a Seamless Desktop Experience
If configuring Microsoft 365 tenant settings is too complex, consider switching to WPS Office. It provides a robust, lightweight desktop application that natively supports all Microsoft Office file formats without requiring complex server-side PowerShell configurations.
- 1. Download WPS Office: Visit the official WPS website and download the free desktop application for your operating system.
- 2. Set as Default Application: During installation, allow WPS Office to be set as the default application for all standard Office file formats.
- 3. Open Files Instantly: Double-click any downloaded Microsoft 365 file to open it immediately in the fast, native WPS desktop app.

Frequently Asked Questions
Why do Microsoft 365 files open in the browser by default?
Microsoft sets the default behavior to open files in Office for the Web to facilitate quick viewing, enable seamless real-time collaboration, and ensure accessibility across devices without requiring the user to install desktop applications.
How long does it take for the Set-SPOTenant command to take effect?
Tenant-wide changes in Microsoft 365 are not always instantaneous. It can take anywhere from a few minutes up to 24 hours for the new default open behavior to fully propagate to all users and SharePoint sites.
Can users override the tenant-wide setting to open in desktop apps?
Yes, the tenant setting only dictates the default behavior. Individual users can still choose to open a file in the browser by right-clicking the file in SharePoint or OneDrive online and selecting 'Open in browser'.




