Disable-SPOSiteRestrictedAppAccessControl
アクティブ モードと両方のリストを維持したまま、サイトに対するアプリケーション制限の適用をオフにします。
構文
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自動化に許可されており、検証、承認、監査、またはファースト パーティ保護をバイパスしません。
関連リンク
- Get-SPOSiteRestrictedAppAccessControl
- Set-SPOSiteRestrictedAppAccessControlMode
- Set-SPOSiteRestrictedAppAccessControlList
- Enable-SPOSiteRestrictedAppAccessControl
- Clear-SPOSiteRestrictedAppAccessControlList
- Clear-SPOSiteRestrictedAppAccessControlPolicy
- Get-SPOTenantRestrictedAppAccessControl
- SharePoint Online 管理シェルの概要