Disable-SPOTenantRestrictedAppAccessControl

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

テナント拒否リストを保持したまま、テナントのアプリケーション制限の適用スイッチをオフにします。

構文

Default (既定) 

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

説明

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

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

テナント スイッチは、アプリケーション制限のマスター強制スイッチです。 テナント拒否リストとすべてのサイトレベルの強制をゲートします。 オフにすると、テナント拒否リストだけでなく、サイト レベルの Enabled フラグが Trueのすべてのサイト ポリシーに対する適用が停止します。 コマンドレットは、確認前にこの影響について警告します。

テナント拒否リストは保持されます。 保存されているテナントとサイトの構成はそのまま残るため、 Enable-SPOTenantRestrictedAppAccessControl を再度実行すると、同じ構成で適用が再開されます。 スイッチを無効 にして テナント拒否リストをクリアする場合は、代わりに Clear-SPOTenantRestrictedAppAccessControlPolicy を使用します。

構成と有効化は 対照的です。このコマンドレットはスイッチのみを変更し、スイッチを切り替えない Set-SPOTenantRestrictedAppAccessControlList で行われた変更を一覧表示します。

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

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

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

例

例 1

Disable-SPOTenantRestrictedAppAccessControl

この例では、テナント強制スイッチをオフにし、テナント拒否リストを保持します。 このコマンドレットは、これにより、サイトレベルの Enabled フラグが Trueになっているすべてのサイト ポリシーへの適用も停止されることを警告し、確認を求めます。

例 2

Disable-SPOTenantRestrictedAppAccessControl -WhatIf

この例は、保存されているテナント ポリシーを変更せずにテナント スイッチをオフにした場合に何が起こるかを示しています。

例 3

Disable-SPOTenantRestrictedAppAccessControl -Confirm:$false
Get-SPOTenantRestrictedAppAccessControl

この例では、自動化に役立つプロンプトを表示せずにテナントの切り替えをオフにした後、テナント ポリシーを読み取り、 Enabled が False であり、保存された拒否リストがまだ RestrictedAppIds 含まれていることを確認します。 プロンプトを非表示にしても、検証、承認、監査、またはファースト パーティ保護はバイパスされません。

パラメーター

-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のすべてのサイト ポリシーに対する適用が停止します。
  • テナント拒否リストと、保存されているすべてのテナントとサイトの構成が保持されます。 スイッチを再度オンにすると、同じ構成で適用が再開されます。
  • 構成と有効化は 対照的です。このコマンドレットは拒否リストを変更しません。
  • 1 回の操作でスイッチを無効にしてテナント拒否リストをクリアするには、 Clear-SPOTenantRestrictedAppAccessControlPolicy を使用します。
  • Disable-SPOSiteRestrictedAppAccessControl を使用して、個々のサイトへの強制をオフにします。