Disable-SPOSiteRestrictedAppAccessControl

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

アクティブ モードと両方のリストを維持したまま、サイトに対するアプリケーション制限の適用をオフにします。

構文

Default (既定) 

Disable-SPOSiteRestrictedAppAccessControl
    -Identity <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

説明

Disable-SPOSiteRestrictedAppAccessControl コマンドレットを使用して、アクティブ モードと両方のリストを維持したまま、1 つのサイトに対するアプリケーション制限の適用をオフにします。 後で Enable-SPOSiteRestrictedAppAccessControl を使用して同じ構成を再度有効にすることができます。

サイトを無効にすることは、サイトを消去することとは異なります。 モードと両方のリストを削除し、保存されているサイト ポリシーを完全にクリアするには、 Clear-SPOSiteRestrictedAppAccessControlPolicy を使用します。

構成と有効化は 対照的です。 モードとリストの変更によって強制が有効になることはありません。このため、サイトを無効にした後でも、強制を再度有効にしなくても、 Set-SPOSiteRestrictedAppAccessControlMode と Set-SPOSiteRestrictedAppAccessControlList による変更のステージングを続行できます。 サイトの強制は、 Enable-SPOSiteRestrictedAppAccessControlによってのみ有効になります。

サイトが無効になっている間は、そのサイトに対する要求にはサイト レベルのアプリケーション制限の決定は適用されません。 テナント レベルのポリシーは影響を受けません。テナント スイッチはすべてのサイトの強制をゲートし、テナント拒否リストをサイト許可リストによってオーバーライドすることはできません。

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

サイト アプリケーションの制限の管理は、汎用の Get-SPOSite および Set-SPOSite コマンドレットから分離されています。 アプリケーションの制限は SiteProperties から完全に切り離されているため、 Get-SPOSite はサイト ポリシー データを読み込まず、 Set-SPOSite 変更できません。 関連リンクに記載されている専用のアプリケーション制限コマンドレットを使用します。

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

例

例 1

Disable-SPOSiteRestrictedAppAccessControl -Identity "https://contoso.sharepoint.com/sites/Finance"

この例では、財務サイトに対するアプリケーション制限の適用をオフにします。 アクティブ モード、許可リスト、拒否リストは保持されます。

例 2

Disable-SPOSiteRestrictedAppAccessControl -Identity "e1b2c3d4-5678-4abc-9def-0123456789ab" -WhatIf

この例ではサイト ID を使用して、ポリシーを変更しない場合に何が起こるかを示します。 すべてのサイト アプリケーション制限コマンドレットは、サイト URL またはサイト ID として -Identity を受け入れます。

例 3

$url = "https://contoso.sharepoint.com/sites/Finance"
Disable-SPOSiteRestrictedAppAccessControl -Identity $url -Confirm:$false
Get-SPOSiteRestrictedAppAccessControl -Identity $url

この例では、対話型プロンプトなしで強制を無効にした後、ポリシーを読み戻して、モードと両方のリストがまだ保存されていることを確認します。 -Confirm:$false を使用しても、検証、承認、監査、またはファースト パーティ保護がバイパスされることはありません。

パラメーター

-Confirm

適用対象: SharePoint Online

コマンドレットを実行する前に確認メッセージを表示します。 このコマンドレットは ConfirmImpact.High を使用するため、既定でプロンプトが表示されます。 -Confirm:$false を使用して、オートメーションでプロンプトを非表示にします。

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

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

パラメーター セット

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

-Identity

適用対象: SharePoint Online

無効にするサイトを指定します。 サイト URL またはサイト ID を指定します。

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

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

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値: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-SPOSiteRestrictedAppAccessControl を使用して、結果のポリシーを読み取ります。

メモ

  • 無効にすると、アクティブ モードと両方のリストが保持されます。 Clear-SPOSiteRestrictedAppAccessControlPolicy を使用してモードとリストを削除し、保存されているサイト ポリシーをクリアします。
  • サイトの強制は、 Enable-SPOSiteRestrictedAppAccessControlによってのみ再び有効になります。 モードとリストの変更は強制をオンにしません。
  • テナントの切り替えは、すべてのサイトの強制をゲートするため、テナントの切り替えがオフの間はサイト ポリシーは効果がありません。 テナント拒否リストは、サイト許可リストによってオーバーライドできません。
  • アプリケーションの制限では、アクセス許可は付与されません。 要求は引き続き、既存の SharePoint 承認に合格する必要があります。
  • このコマンドレットは、ConfirmImpact.High での-WhatIfと-Confirmをサポートします。 -Confirm:$false 自動化に許可されており、検証、承認、監査、またはファースト パーティ保護をバイパスしません。