Muokkaa

Jaa

Set-SPOApplication

  • Reference
Module:
Microsoft.Online.SharePoint.PowerShell

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.

To invite people outside your organization, please make sure Microsoft Entra B2B is enabled.

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.

Example 3

Set-SPOTenant -EnableAzureADB2BIntegration $true
Set-SPOApplication -OwningApplicationId 423poi45-jikl-9bnm-b302-1234ghy56789 -OverrideTenantSharingCapability $true -SharingCapability -ExternalUserandGuestSharing

This example demonstrates how to enable file sharing within the SharePoint Embedded application for external users. Note that B2B integration must be enabled to allow guest invitations to SharePoint Embedded apps.

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