Set-SPOApplication
SharePoint Embedded アプリケーションの 1 つ以上の構成を設定または更新します。
構文
Default (既定)
Set-SPOApplication
[-OwningApplicationId] <Guid>
[[-SharingCapability] <SharingCapabilities>]
[[-OverrideTenantSharingCapability] <Boolean>]
[[-ItemMajorVersionLimit] <Int>]
[[-EnableAutoExpirationVersionTrim] <Boolean>]
[[-ExpireVersionsAfterDays] <Int>]
[[-FileTypesForVersionExpiration] <String[]>]
[[-RemoveVersionExpirationFileTypeOverride] <String[]>]
[<CommonParameters>]
説明
Set-SPOApplication コマンドレットは、 OwningApplicationIdによって決定される特定のアプリケーションの構成プロパティを設定するために使用されます。
このコマンドレットを実行するには、SharePoint Embedded 管理者である必要があります。
注:
Microsoft Loop の OwningApplicationId は a187e399-0c36-4b98-8f04-1edc167a0996 です。
Microsoft Designer の OwningApplicationId は 5e2795e3-ce8c-4cfb-b302-35fe5cd01597 です。
organization 外のユーザーを招待するには、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 Online テナント設定に関係なく、SharePoint Embedded アプリケーション内のファイル共有を社内ユーザーのみに制限するオーバーライドを有効にします。
例 3
Set-SPOTenant -EnableAzureADB2BIntegration $true
Set-SPOApplication -OwningApplicationId 423poi45-jikl-9bnm-b302-1234ghy56789 -OverrideTenantSharingCapability $true -SharingCapability ExternalUserandGuestSharing
この例では、外部ユーザーに対して SharePoint Embedded アプリケーション内でファイル共有を有効にする方法を示します。 SharePoint Embedded アプリへのゲスト招待を許可するには、B2B 統合を有効にする必要があることに注意してください。
例 4
Set-SPOApplication -OwningApplicationId 423poi45 -ItemMajorVersionLimit 1000
この例では、ItemMajorVersionLimit を 1000 に設定します。
例 5
Set-SPOApplication -OwningApplicationId 423poi45 -EnableAutoExpirationVersionTrim $true
この例では、アプリケーションのコンテナーの自動バージョン履歴トリミングを有効にします。 自動トリミングを有効にすると、 ExpireVersionsAfterDays と ItemMajorVersionLimit は自動的に管理され、同時に設定することはできません。
例 6
Set-SPOApplication -OwningApplicationId 423poi45 -EnableAutoExpirationVersionTrim $false -ItemMajorVersionLimit 500 -ExpireVersionsAfterDays 180
この例では、自動トリミングを無効にし、手動バージョン ポリシーを設定します。
EnableAutoExpirationVersionTrim を$falseする場合は、ItemMajorVersionLimit と ExpireVersionsAfterDays の両方を指定する必要があります。
例 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- 手動バージョン ポリシーが使用されます。ItemMajorVersionLimitとExpireVersionsAfterDaysの両方を指定する必要があります。
パラメーターのプロパティ
| 型: | System.Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 5 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ExpireVersionsAfterDays
ファイル バージョンの有効期限が切れる日数。 値 0 は、バージョンの有効期限が切れないことを意味します。 それ以外の場合、値は 30 から 36500 の間である必要があります。 このパラメーターは、 EnableAutoExpirationVersionTrim が $trueのときには使用できません。
パラメーターのプロパティ
| 型: | Int |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 6 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-FileTypesForVersionExpiration
バージョン有効期限ポリシーを更新する必要があるファイルの種類。 配列を空にすることはできません。また、 EnableAutoExpirationVersionTrim、 ItemMajorVersionLimit、または ExpireVersionsAfterDays のいずれか 1 つを指定する必要があります。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 7 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ItemMajorVersionLimit
このパラメーターは、コンテナーの種類の ItemMajorVersionLimit をオーバーライドするために使用されます。 有効な値は 1 から 50000 です。
パラメーターのプロパティ
| 型: | Int |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 4 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-OverrideTenantSharingCapability
この設定を使用すると、アプリケーションは共有機能を個別に設定して、SharePoint Online のテナント レベルの設定を上書きできます。 オプション:
- False (既定値) - アプリケーションはテナント レベルの共有機能に従います
- True - アプリケーションの共有設定は、テナント レベルの共有機能とは無関係です
パラメーターのプロパティ
| 型: | System.Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 2 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-OwningApplicationId
このパラメーターは、SharePoint 埋め込みアプリケーションの ID を指定します。
パラメーターのプロパティ
| 型: | System.Guid |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-RemoveVersionExpirationFileTypeOverride
削除するファイルの種類のバージョン有効期限のオーバーライド。 配列を空にすることはできません。 このパラメーターは排他的であり、 FileTypesForVersionExpiration、 EnableAutoExpirationVersionTrim、 ItemMajorVersionLimit、または ExpireVersionsAfterDays と組み合わせることはできません。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 8 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SharingCapability
SharePoint 埋め込みアプリケーションで使用できる共有レベルを決定します。
有効な値は次のいずれかです:
- ExternalUserAndGuestSharing (既定値) - 外部ユーザー共有 (メールで共有) とゲスト リンク共有の両方が有効になります。
- Disabled - 外部ユーザー共有 (メールで共有) とゲスト リンク共有の両方が無効になります。
- ExternalUserSharingOnly - 外部ユーザー共有 (メールで共有) は有効になりますが、ゲスト リンク共有は無効になります。
- ExistingExternalUserSharingOnly - 既にorganizationのディレクトリに存在するゲストのみ。
既定の設定は [なし] です。これは、アプリケーションが SharePoint Online テナント レベルの共有設定に従うことを意味します。
Get-SPOTenant コマンドレットを使用して、これらの設定を表示します。
パラメーターのプロパティ
| 型: | Microsoft.Online.SharePoint.TenantManagement.SharingCapabilities |
| 規定値: | None |
| 指定可能な値: | Disabled, ExternalUserSharingOnly, ExternalUserAndGuestSharing, ExistingExternalUserSharingOnly |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。