Enable-SPOTenantRestrictedAppAccessControl

モジュール:
Microsoft.Online.SharePoint.PowerShell Module

organization のテナントのアプリケーション制限の適用スイッチを有効にします。

構文

Default (既定) 

Enable-SPOTenantRestrictedAppAccessControl
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

説明

Enable-SPOTenantRestrictedAppAccessControl コマンドレットを使用して、アプリケーション制限のテナント強制スイッチをオンにします。

アプリケーションの制限により、Microsoft Entra の同意と SharePoint のアクセス許可が既に付与されているアプリケーションに対して、SharePoint 承認の境界が追加されます。 アクセス許可は付与されず、Entra の同意に取って代わるものでもありません。 要求は、既存のアクセス許可モデルとアプリケーション制限の両方を通過する必要があります。

テナント スイッチは、アプリケーション制限のマスター強制スイッチです。 オフの間、テナント拒否リストは適用されず、サイト レベルのポリシーは適用されません。 スイッチをオンにすると、サイト レベルの Enabled フラグが True のサイト ポリシーに対してのみ、テナント拒否リストの適用とサイト レベルの強制が開始されます。 無効なサイト ポリシーの適用は開始されません。 スイッチを有効にする前に、保存されているテナント拒否リストを Get-SPOTenantRestrictedAppAccessControl で確認し、有効なサイト ポリシーを確認します。

スイッチを有効にしても、格納されている拒否リストは変更されません。 構成と有効化は 対照的です。このコマンドレットはスイッチのみを変更し、スイッチを切り替えない Set-SPOTenantRestrictedAppAccessControlList で行われた変更を一覧表示します。 スイッチがオフの間に保存されていた設定で適用が再開されます。

テナント拒否リストが空の有効なスイッチは有効な状態ですが、テナント拒否リストはアプリケーション ID が追加されるまで何も拒否しません。

テナント スコープは拒否のみで、1 つのリストがあるため、テナント スコープにモード コマンドレットと -ListType パラメーターはありません。

テナント アプリケーションの制限の管理は、汎用の Get-SPOTenant および Set-SPOTenant コマンドレットから分離されています。 Application Restrictions は Tenant プロパティとして公開されないため、 Get-SPOTenant はポリシーを返さず、 Set-SPOTenant を変更できません。

SharePoint Online の Windows PowerShell のアクセス許可と最新の情報については、「SharePoint Online 管理シェルの概要」を参照してください。

例

例 1

Enable-SPOTenantRestrictedAppAccessControl

この例では、テナント強制スイッチを有効にします。 テナント拒否リストの適用と共に、サイト レベルの Enabled フラグが True のサイト ポリシーに対するサイト レベルの適用が開始されます。 無効なサイト ポリシーの適用は開始されません。 コマンドレットは、この影響について警告し、確認を求めます。

例 2

Get-SPOTenantRestrictedAppAccessControl
Enable-SPOTenantRestrictedAppAccessControl

この例では、まず格納されているテナント ポリシーを確認して、拒否リストに含まれているアプリケーション ID を確認してから、強制を有効にします。 サイト レベルの強制は、サイト レベルの Enabled フラグが True のサイト ポリシーに対してのみ開始されます。

例 3

Enable-SPOTenantRestrictedAppAccessControl -WhatIf

この例は、保存されているテナント ポリシーを変更せずにテナントの切り替えが有効になった場合にどうなるかを示しています。

例 4

Enable-SPOTenantRestrictedAppAccessControl -Confirm:$false

この例では、確認を要求せずにテナント スイッチを有効にします。これは自動化に役立ちます。 プロンプトを非表示にしても、検証、承認、監査、またはファースト パーティ保護はバイパスされません。

パラメーター

-Confirm

適用対象: SharePoint Online

コマンドレットを実行する前に確認メッセージを表示します。 このコマンドレットは ConfirmImpact.High を使用するため、既定でプロンプトが表示されます。 -Confirm:$false を使用して、オートメーションでプロンプトを非表示にします。 プロンプトを非表示にしても、検証、承認、監査、またはファースト パーティ保護はバイパスされません。

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

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

パラメーター セット

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

-WhatIf

適用対象: SharePoint Online

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

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

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

パラメーター セット

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

CommonParameters

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

入力

None

出力

None

このコマンドレットは出力オブジェクトを返しません。 Get-SPOTenantRestrictedAppAccessControl を使用して、結果のテナント ポリシーを確認します。

メモ

  • テナントの切り替えを有効にすると、サイト レベルの Enabled フラグが True のサイト ポリシーに対してのみ、テナント拒否リストの適用とサイト レベルの強制が開始されます。 無効なサイト ポリシーの適用は開始されません。
  • テナント スイッチはマスター強制スイッチです。 オフになっている間は、テナント拒否リストとすべてのサイトレベルのポリシーは適用されません。
  • スイッチを有効にしても、格納されている拒否リストは変更されません。 構成と有効化は 対照的です。
  • 空の拒否リストを持つ有効なスイッチは許可されますが、アプリケーション ID が追加されるまで、テナント拒否リストは何も拒否しません。
  • Microsoft のファースト パーティおよびコア アプリケーションは、アプリケーションの制限の構成と適用の対象外です。
  • Enable-SPOSiteRestrictedAppAccessControl を使用して、個々のサイトへの強制を有効にします。