Set-SPOApplication
設定或更新 SharePoint Embedded 應用程式的一或多個設定。
語法
Default (預設值)
Set-SPOApplication
[-OwningApplicationId] <Guid>
[[-SharingCapability] <SharingCapabilities>]
[[-OverrideTenantSharingCapability] <Boolean>]
[[-ItemMajorVersionLimit] <Int>]
[[-EnableAutoExpirationVersionTrim] <Boolean>]
[[-ExpireVersionsAfterDays] <Int>]
[[-FileTypesForVersionExpiration] <String[]>]
[[-RemoveVersionExpirationFileTypeOverride] <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 -ItemMajorVersionLimit 1000
此範例會將 ItemMajorVersionLimit 設定為 1000。
範例 5
Set-SPOApplication -OwningApplicationId 423poi45 -EnableAutoExpirationVersionTrim $true
此範例會為應用程式的容器啟用自動版本歷程記錄修剪。 啟用自動修剪時， ExpireVersionsAfterDaysItemMajorVersionLimit 並且自動管理，無法同時設定。
範例 6
Set-SPOApplication -OwningApplicationId 423poi45 -EnableAutoExpirationVersionTrim $false -ItemMajorVersionLimit 500 -ExpireVersionsAfterDays 180
此範例會停用自動修剪並設定手動版本原則。 時 EnableAutoExpirationVersionTrim 是 $false，兩者皆ItemMajorVersionLimitExpireVersionsAfterDays必須指定。
範例 7
Set-SPOApplication -OwningApplicationId 423poi45 -ExpireVersionsAfterDays 365 -FileTypesForVersionExpiration "docx","xlsx"
此範例會將版本到期原則套用至指定的檔案類型。
範例 8
Set-SPOApplication -OwningApplicationId 423poi45 -RemoveVersionExpirationFileTypeOverride "docx","xlsx"
本範例會移除指定檔案類型的檔案類型版本到期覆寫。
RemoveVersionExpirationFileTypeOverride 不能與任何其他版本原則參數結合使用。
參數
-EnableAutoExpirationVersionTrim
啟用或停用 SharePoint Embedded 應用程式容器的自動檔案版本歷程記錄修剪。
-
$true- 系統會自動管理版本歷程記錄限制。ExpireVersionsAfterDays且ItemMajorVersionLimit無法同時指定。 -
$false- 使用手動版本原則。 兩者都ItemMajorVersionLimitExpireVersionsAfterDays必須指定。
參數屬性
| 類型: | System.Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 5 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ExpireVersionsAfterDays
檔案版本到期的天數。 值為 0 表示版本永不過期。 否則，值必須介於 30 到 36500 之間。 此參數無法在 為$true時EnableAutoExpirationVersionTrim使用。
參數屬性
| 類型: | Int |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 6 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-FileTypesForVersionExpiration
版本到期原則應更新的檔案類型。 陣列不能為空白，且至少必須指定 、 ItemMajorVersionLimit或 ExpireVersionsAfterDays 中的EnableAutoExpirationVersionTrim一個。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 7 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ItemMajorVersionLimit
此參數可用來覆寫容器類型的 ItemMajorVersionLimit。 有效值介於 1 到 50000 之間。
參數屬性
| 類型: | Int |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 4 |
| 必要: | 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 |
-RemoveVersionExpirationFileTypeOverride
檔案類型 version-expiration 會覆寫以移除。 陣列不能為空白。 此參數為獨佔參數，無法與 FileTypesForVersionExpiration、 EnableAutoExpirationVersionTrim、 ItemMajorVersionLimit或 ExpireVersionsAfterDays結合使用。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 8 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SharingCapability
決定 SharePoint Embedded 應用程式可用的共用層級。
有效的值為：
- ExternalUserAndGuestSharing (預設值) - 外部使用者共用 (以電子郵件共用) 和來賓連結共用均已啟用。
- Disabled - 外部使用者共用 (以電子郵件共用) 和來賓連結共用均已停用。
- ExternalUserSharingOnly - 外部使用者共用 (以電子郵件共用) 已啟用，但來賓連結共用已停用。
- ExistingExternalUserSharingOnly - 僅限貴組織目錄中已存在的來賓。
預設設定為 [無]，表示應用程式遵循 SharePoint Online 租用戶層級共用設定。 使用 Get-SPOTenant Cmdlet 來檢視這些設定。
參數屬性
| 類型: | 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。