Set-SPOApplication
Sets or updates one or more property values for a SharePoint application.
Syntax
Set-SPOApplication
[-OwningApplicationId <OwningApplicationId>]
[-SharingCapability <SharingCapability>]
[-OverrideTenantSharingCapability <Boolean>]
Description
Set-SPOApplication
adjusts the sharing settings at the SharePoint Embedded application level, determining if this SharePoint Embedded application content can be shared with external guests.
You must be a SharePoint Embedded Administrator or Global Administrator to run the cmdlet.
Note
The OwningApplicationId for Microsoft Loop is a187e399-0c36-4b98-8f04-1edc167a0996
.
The OwningApplicationId for Microsoft Designer is 5e2795e3-ce8c-4cfb-b302-35fe5cd01597
.
Examples
Example 1
Set-SPOApplication -OwningApplicationId 423poi45-jikl-9bnm-b302-1234ghy56789 -OverrideTenantSharingCapability $false
This example disables the override sharing capability, aligning this SharePoint Embedded application's sharing settings with sharing capability of the SharePoint Online.
Example 2
Set-SPOApplication -OwningApplicationId 423poi45-jikl-9bnm-b302-1234ghy56789 -OverrideTenantSharingCapability $true -SharingCapability -Disabled
This example enables the override, restricting file sharing within the SharePoint Embedded application to internal company users only, regardless of the broader SharePoint Online tenant settings.
Parameters
-OverrideTenantSharingCapability
This setting allows the application to independently set its sharing capabilities, overriding the tenant-level settings of SharePoint Online. Options:
- False (default) - The application follows the tenant-level sharing capability
- True - The application's sharing settings are independent of the tenant level sharing capability
Type: | Boolean |
Position: | Named |
Default value: | False |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Embedded |
-SharingCapability
Determines what level of sharing is available for the SharePoint Embedded Application.
The valid values are:
- ExternalUserAndGuestSharing (default) - External user sharing (share by email) and guest link sharing are both enabled.
- Disabled - External user sharing (share by email) and guest link sharing are both disabled.
- ExternalUserSharingOnly - External user sharing (share by email) is enabled, but guest link sharing is disabled.
- ExistingExternalUserSharingOnly - Only guests already in your organization's directory.
The default setting is None, meaning the application follows the SharePoint Online tenant-level sharing settings. Use the Get-SPOTenant
cmdlet to view these settings.
Type: | SharingCapabilities |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Embedded |