Set-SPOContainerTypeConfiguration

SharePoint Embedded のコンテナーの種類の構成設定を設定または更新します。

構文

Default (既定)

Set-SPOContainerTypeConfiguration
    -ContainerTypeId <Guid>
    [-DiscoverabilityDisabled <Boolean>]
    [-SharingRestricted <Boolean>]
    [-ApplicationRedirectUrl <String>]
    [-WhoCanShareAnonymousAllowList <Guid[]>]
    [-WhoCanShareAuthenticatedGuestAllowList <Guid[]>]
    [-OverrideTenantWhoCanShareAnonymousAllowList <Boolean>]
    [-OverrideTenantWhoCanShareAuthenticatedGuestAllowList <Boolean>]
    [-AnonymousLinkExpirationInDays <Int32>]
    [-IsArchiveEnabled <Boolean>]
    [-UseLegacyItemWebUrl <Boolean>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

説明

渡されたパラメーターに対して、 Set-SPOContainerTypeConfiguration コマンドレットは、SharePoint Embedded アプリケーションで作成されたコンテナーの種類の設定を設定または更新します。

このコマンドレットを実行するには、SharePoint Embedded 管理者である必要があります。

例

例 1

Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4 -DiscoverabilityDisabled $false

例 1 では、このコンテナーの種類の検出可能性をオンにします。 このコンテナーの種類内で作成されたすべてのコンテンツは、office.com、onedrive.com、推奨ファイル、その他のインテリジェント検出エクスペリエンスを含め、Microsoft 365 エクスペリエンスで検出できます。

例 2

Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4 -SharingRestricted $false

例 2 では、このコンテナーの種類に対してオープン共有モデルが有効になります。 編集アクセス許可を持つコンテナー メンバーとゲスト ユーザーは、コンテナーの種類内で作成されたファイルを共有できます。

例 3

Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4 -OverrideTenantWhoCanShareAnonymousAllowList $true -WhoCanShareAnonymousAllowList <guids>

例 3 では、テナント レベルの WhoCanShareAnonymousAllowListがオーバーライドされます。

例 4

Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4 -OverrideTenantWhoCanShareAnonymousAllowList $true –WhoCanShareAnonymousAllowList $null -OverrideTenantWhoCanShareAuthenticatedGuestAllowList $true –WhoCanShareAuthenticatedGuestAllowList $null

例 4 では、テナント レベルのWhoCanShareAnonymousAllowListとWhoCanShareAuthenticatedGuestAllowListを null 値で上書きし、チェックをバイパスします。 これにより、外部共有権限が特定のセキュリティ グループのメンバーに制限されなくなる効果があります。

例 5

Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4 -OverrideTenantWhoCanShareAuthenticatedGuestAllowList $true –WhoCanShareAuthenticatedGuestAllowList $null

例 5 では、WhoCanShareAnonymousAllowListはそのままにして、テナント レベルのWhoCanShareAuthenticatedGuestAllowListを null 値で上書きします。 これにより、認証されたゲストと共有する権限を、特定のセキュリティ グループのメンバーに制限しなくなりました。

例 6

Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4 -IsArchiveEnabled $true

例 6 では、ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4 のすべてのコンテナーに対するアーカイブおよび再アクティブ化アクションのサポートを有効にしています。

例 7

Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4 -UseLegacyItemWebUrl $true

例 7 では、ContainerType ID 4f0af585-8dcc-0000-223d-661eb2c604e4 のコンテナーが、レガシ アイテム WebUrl の使用を一時的に継続するように構成します。

パラメーター

-AnonymousLinkExpirationInDays

値の設定後に作成されたすべての匿名リンクが、設定された日数後に期限切れになることを指定します。

値は 1 日から 730 日までです。

テナント レベルの設定に従うには、値を -1 に設定します。

パラメーターのプロパティ

型:System.Int32
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ApplicationRedirectUrl

このパラメーターは、アプリケーションをリダイレクトする URL を指定します。

パラメーターのプロパティ

型:System.String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

パラメーターのプロパティ

型:System.Management.Automation.SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:Cf

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ContainerTypeId

このパラメーターは、SharePoint Embedded アプリケーションに対応するコンテナーの種類の ID を指定します。

パラメーターのプロパティ

型:System.Guid
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-DiscoverabilityDisabled

適用対象: SharePoint Embedded

Microsoft 365 の SharePoint 管理者は、Microsoft 365 エクスペリエンスにコンテンツを表示する方法を制御できます。 この値が true の場合、SharePoint 埋め込みアプリケーションのコンテンツは、office.com、onedrive.com、推奨セクション、またはその他の Microsoft インテリジェント ファイル検出機能を含め、Microsoft 365 環境全体で非表示になります。 Microsoft 365 エクスペリエンスを選択すると、ファイルはインテリジェントなファイル検出に参加して Microsoft 365 環境に統合されます。

パラメーター値: True |False

パラメーターのプロパティ

型:System.Boolean
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-IsArchiveEnabled

コンテナーのアーカイブを有効にするには、 -IsArchiveEnabled フラグを使用します。 アーカイブはデータをコールド層に移動し、ストレージコストを削減します。 アーカイブされている間は、再度アクティブ化するまでコンテンツにアクセスできません。 再アクティブ化は最初の 7 日以内にすぐに行われますが、その後は最大 24 時間かかる場合があります。 このフラグを含めない場合、値の既定値は False になり、すべてのアーカイブ API 呼び出しは失敗します。 フラグを更新した後、使用中のテナントで変更が有効になるまで最大 24 時間かかります。

パラメーターのプロパティ

型:System.Boolean
規定値:False
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-OverrideTenantWhoCanShareAnonymousAllowList

この設定は、コンテナーの種類 WhoCanShareAnonymousAllowList がテナント レベルの WhoCanShareAnonymousAllowListをオーバーライドするかどうかを決定します。

パラメーター値: True |False

パラメーターのプロパティ

型:Boolean
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-OverrideTenantWhoCanShareAuthenticatedGuestAllowList

この設定は、コンテナーの種類 WhoCanShareAuthenticatedGuestAllowList がテナント レベルの WhoCanShareAuthenticatedGuestAllowListをオーバーライドするかどうかを決定します。

パラメーター値: True |False

パラメーターのプロパティ

型:System.Boolean
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-SharingRestricted

適用対象: SharePoint Embedded

SharePoint Embedded には、開発者がコンテナーのアクセス許可の役割に基づいてファイル共有アクセス許可を構成できる役割ベースの共有モデルが用意されており、制限付き共有モデルとオープン共有モデルのどちらかを選択できます。 オープン共有モデルでは、編集アクセス許可を持つコンテナー メンバーとゲスト ユーザーがファイルを共有できます。 制限付き共有モデルでは、所有者または管理者であるコンテナー メンバーのみがファイルを共有できます。

パラメーター値: True |False

パラメーターのプロパティ

型:System.Boolean
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-UseLegacyItemWebUrl

有効にすると、新しい SharePoint 埋め込みアイテム WebUrl の代わりに従来のアイテム WebUrl 形式を一時的に使用されます。

パラメーターのプロパティ

型:System.Boolean
規定値:False
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

パラメーターのプロパティ

型:System.Management.Automation.SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:wi

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-WhoCanShareAnonymousAllowList

匿名の (認証されていない) ユーザーおよび認証されたゲスト ユーザーとの共有が許可されるセキュリティ グループのコンテナーの種類固有の一覧を設定します。 これは OverrideTenantWhoCanShareAnonymousAllowList と組み合わせて設定する必要があります。

注:

この許可リストは、セキュリティ グループのみを受け入れ、Microsoft 365 グループは受け入れません。

各セキュリティ グループは、その GUID オブジェクト ID で示されます。 この一覧を特定のセキュリティ グループに設定するには、その GUID をパラメーターとして入力する必要があります。 複数の GUID は、コンマを使用して区切ることができます。 チェックをスキップし、すべてのセキュリティ グループが誰とでも共有できるようにするには、この許可リストとWhoCanShareAuthenticatedGuestAllowListを null 配列に設定します。

パラメーターのプロパティ

型:

System.Guid[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-WhoCanShareAuthenticatedGuestAllowList

コンテナー レベルで認証されたゲスト ユーザーとの共有を許可されるセキュリティ グループのコンテナーの種類固有の一覧を設定します。 これは OverrideTenantWhoCanShareAuthenticatedGuestAllowList と組み合わせて設定する必要があります。

注:

この許可リストは、セキュリティ グループのみを受け入れ、Microsoft 365 グループは受け入れません。

各セキュリティ グループは、その GUID オブジェクト ID で示されます。 この一覧を特定のセキュリティ グループに設定するには、その GUID をパラメーターとして入力する必要があります。 複数の GUID は、コンマを使用して区切ることができます。 チェックをスキップし、すべてのセキュリティ グループが認証されたゲストと共有できるようにするには、この許可リストを null 配列に設定します。

パラメーターのプロパティ

型:

System.Guid[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。

入力

None

出力

System.Object