Set-SPOApplication
設定或更新 SharePoint Embedded 應用程式的一或多個組態。
語法
Default (預設值)
Set-SPOApplication
[-OwningApplicationId] <Guid>
[[-SharingCapability] <SharingCapabilities>]
[[-OverrideTenantSharingCapability] <Boolean>]
[[-CopilotEmbeddedChatHosts] <System.Collections.Generic.List`1[System.String]>]
[<CommonParameters>]
Description
Set-SPOApplication Cmdlet 是用來設定特定應用程式的組態屬性，由 決定 OwningApplicationId。
您必須是 SharePoint Embedded 系統管理員才能執行此 Cmdlet。
注意事項
Microsoft Loop 的 OwningApplicationId 為 a187e399-0c36-4b98-8f04-1edc167a0996。
Microsoft Designer 的 OwningApplicationId 為 5e2795e3-ce8c-4cfb-b302-35fe5cd01597。
若要邀請組織外部的人員，請確定已啟用 Microsoft Entra B2B。
範例
範例 1
Set-SPOApplication -OwningApplicationId 423poi45-jikl-9bnm-b302-1234ghy56789 -OverrideTenantSharingCapability $false
此範例會停用覆寫共用功能，將此 SharePoint Embedded 應用程式的共享設定與 SharePoint Online 的共用功能對齊。
範例 2
Set-SPOApplication -OwningApplicationId 423poi45-jikl-9bnm-b302-1234ghy56789 -OverrideTenantSharingCapability $true -SharingCapability Disabled
此範例會啟用 覆寫，將 SharePoint Embedded 應用程式內的檔案共用限制為僅限內部公司使用者，而不論更廣泛的 SharePoint Online 租使用者設定為何。
範例 3
Set-SPOTenant -EnableAzureADB2BIntegration $true
Set-SPOApplication -OwningApplicationId 423poi45-jikl-9bnm-b302-1234ghy56789 -OverrideTenantSharingCapability $true -SharingCapability ExternalUserandGuestSharing
此範例示範如何在 SharePoint Embedded 應用程式內為外部使用者啟用檔案共用。 請注意，必須啟用 B2B 整合，才能允許來賓邀請 SharePoint Embedded 應用程式。
範例 4
Set-SPOApplication -OwningApplicationId 423poi45 -CopilotEmbeddedChatHosts "https://localhost:3000 https://contoso.sharepoint.com https://fabrikam.com"
本範例會設定標識碼為 423poi45 的應用程式主機 URL。
參數
-CopilotEmbeddedChatHosts
此參數可用來新增允許使用 SharePoint Embedded 應用程式宣告式代理程式體驗的主機 URL。 這一律會是應用程式開發人員所設定的允許URL子集。 若要檢查允許的 URL 清單，請使用 Get-SPOApplication Cmdlet。
參數屬性
| 類型: | System.Collections.Generic.List`1[System.String] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 3 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-OverrideTenantSharingCapability
此設定可讓應用程式獨立設定其共用功能，並覆寫 SharePoint Online 的租用戶層級設定。 選項：
- False (預設) - 應用程式遵循租用戶層級共用功能
- True - 應用程式的共享設定與租用戶層級共用功能無關
參數屬性
| 類型: | System.Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 2 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-OwningApplicationId
此參數會指定 SharePoint Embedded 應用程式的識別碼。
參數屬性
| 類型: | System.Guid |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SharingCapability
決定 SharePoint Embedded 應用程式可用的共享層級。
有效的值為：
- ExternalUserAndGuestSharing (預設值) - 外部使用者共用 (以電子郵件共用) 和來賓連結共用均已啟用。
- Disabled - 外部使用者共用 (以電子郵件共用) 和來賓連結共用均已停用。
- ExternalUserSharingOnly - 外部使用者共用 (以電子郵件共用) 已啟用，但來賓連結共用已停用。
- ExistingExternalUserSharingOnly - 只有已經在您組織目錄中的來賓。
默認設定為 [無]，這表示應用程式會遵循 SharePoint Online 租使用者層級的共享設定。 使用 Cmdlet Get-SPOTenant 來檢視這些設定。
參數屬性
| 類型: | Microsoft.Online.SharePoint.TenantManagement.SharingCapabilities |
| 預設值: | None |
| 接受的值: | Disabled, ExternalUserSharingOnly, ExternalUserAndGuestSharing, ExistingExternalUserSharingOnly |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。