Modifica

Condividi tramite

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.

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