Clear-SPOTenantRestrictedAppAccessControlPolicy

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

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

構文

Default (既定) 

Clear-SPOTenantRestrictedAppAccessControlPolicy
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

説明

Clear-SPOTenantRestrictedAppAccessControlPolicy コマンドレットを使用して、テナントのアプリケーション制限ポリシーをリセットします。 コマンドレットは、テナント強制スイッチを無効にし、1 回の操作でテナント全体の拒否リストをクリアします。

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

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

テナント スコープは、1 つのリストを含む拒否のみであるため、個別のクリア リスト コマンドレットはありません。 有効なサイト ポリシーに対してテナント スイッチを有効にしたまま、拒否リストを空にするには、 Set-SPOTenantRestrictedAppAccessControlList でそのアプリケーション ID を削除します。 Clear-SPOTenantRestrictedAppAccessControlPolicy を使用してテナント ポリシーを完全に削除します。

テナント構成を完全に削除する場合は、このコマンドレットを使用します。 強制を停止し、拒否リストは後で使用するために保持する場合は、代わりに Disable-SPOTenantRestrictedAppAccessControl を使用します。 選択したアプリケーション ID のみを削除する場合は、-RemoveRestrictedAppIds で Set-SPOTenantRestrictedAppAccessControlList を使用します。

ID の削除には Microsoft Graph は必要ないため、テナント拒否リストにある古いアプリケーションまたは削除されたアプリケーションは、リストの残りの部分と共にクリアされます。

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

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

例

例 1

Clear-SPOTenantRestrictedAppAccessControlPolicy

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

例 2

Clear-SPOTenantRestrictedAppAccessControlPolicy -WhatIf

この例は、格納されているテナント ポリシーを変更せずにテナント ポリシーがクリアされた場合にどうなるかを示しています。

例 3

Get-SPOTenantRestrictedAppAccessControl
Clear-SPOTenantRestrictedAppAccessControlPolicy -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 を使用して、結果のテナント ポリシーを確認します。

メモ

  • このコマンドレットは、テナントの切り替えを無効にし、テナント拒否リストをクリアします。 拒否リストを保持しながら強制を停止するには、 Disable-SPOTenantRestrictedAppAccessControl を使用します。
  • テナントの切り替えは、テナント拒否リスト、およびすべてのサイトレベルの強制をゲートします。 オフにすると、テナント拒否リストだけでなく、サイト レベルの Enabled フラグが Trueのすべてのサイト ポリシーに対する適用が停止します。 コマンドレットは、確認前にこの影響について警告します。
  • テナント スコープは、1 つのリストを含む拒否のみであるため、テナント スコープに個別のクリアリスト コマンドレットはありません。
  • クリアしても Microsoft Graph は呼び出されないため、古いアプリケーション ID や削除されたアプリケーション ID はリストの残りの部分と共に削除されます。
  • このコマンドレットは、サイト ポリシーの構成を削除しません。 Clear-SPOSiteRestrictedAppAccessControlPolicy を使用して、個々のサイトのポリシーをクリアします。