Enable-SPOSiteRestrictedAppAccessControl

Модуль:
Microsoft.Online.SharePoint.PowerShell Module

Включает принудительное применение ограничений приложений для сайта с использованием его настроенных режима и списков.

Синтаксис

Default (По умолчанию) 

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

Описание

Используйте командлет, Enable-SPOSiteRestrictedAppAccessControl чтобы включить принудительное применение ограничений приложений для одного сайта. Режим уже должен быть настроен с Set-SPOSiteRestrictedAppAccessControlModeпомощью ; командлет завершается сбоем, если режим не установлен.

Принудительное использование прав на сайте включается только этим командлетом. Конфигурация и включение независимы: изменения режима и списка никогда не включают принудительное применение. Администратор может разместить политику с помощью Set-SPOSiteRestrictedAppAccessControlMode и Set-SPOSiteRestrictedAppAccessControlList затем включить ее явным образом.

Активный режим определяет решение политики сайта:

  • Разрешить - приложения в списке разрешений проходят проверку ограничений приложений, а все другие управляемые приложения отклоняются политикой сайта. Пустой список активных разрешений приводит к тому, что политика сайта запрещает все управляемые сторонние и агентские приложения.
  • Запретить - приложения в списке запрещенных запрещены политикой сайта, а все другие управляемые приложения проходят проверку ограничений приложений.

Неактивный список сохраняется и не влияет на время выполнения.

Переключение клиента обеспечивает принудительное применение всех сайтов. Политика сайта не действует, пока выключен переключатель клиента, и список отказов клиентов не может быть переопределен списком разрешенных сайтов. Используется Get-SPOTenantRestrictedAppAccessControl для подтверждения переключения клиента, прежде чем переходить к политике сайта.

Ограничения приложений Добавляет границу авторизации SharePoint для приложений, у которых уже есть согласие Microsoft Entra и разрешения SharePoint. Он никогда не предоставляет разрешения и не заменяет согласие Microsoft Entra. Запрос должен соответствовать как существующей модели разрешений, так и ограничениям приложений.

Администрирование ограничений приложений сайта изолировано от общего назначения Get-SPOSite и Set-SPOSite командлетов. Ограничения приложений полностью отделены от SiteProperties, поэтому Get-SPOSite не загружают данные политики сайта и Set-SPOSite не могут их изменить. Используйте специальные командлеты ограничений приложений, перечисленные в связанных ссылках.

Собственные и основные приложения Майкрософт исключаются из настройки и применения ограничений на использование приложений.

Сведения о разрешениях и самую последнюю информацию о Windows PowerShell для SharePoint Online см. в электронной документации Знакомство с командной консолью SharePoint Online.

Примеры

Пример 1

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

В этом примере включается принудительное применение ограничений приложений для финансового сайта, определенного по его URL-адресу. Для принудительного применения используются режим и списки, которые уже настроены на сайте.

Пример 2

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

В этом примере принудительное применение включается для сайта, определенного по его идентификатору. Каждый сайт Командлет Application Restrictions может обозначать -Identity URL-адрес или идентификатор сайта.

Пример 3

$url = "https://contoso.sharepoint.com/sites/Finance"
Set-SPOSiteRestrictedAppAccessControlMode -Identity $url -Mode Allow
Set-SPOSiteRestrictedAppAccessControlList -Identity $url -ListType AllowList -AddRestrictedAppIds "11111111-1111-1111-1111-111111111111"
Enable-SPOSiteRestrictedAppAccessControl -Identity $url

В этом примере настраивается режим и список разрешений, а затем политика включается явным образом. Изменения режима и списка не включают принудительное применение, поэтому ничего не применяется до тех пор, пока не будет выполнена последняя команда. Приложения в списке разрешений проходят проверку ограничений приложений; все другие управляемые приложения отклоняются политикой сайта. Существующие условия согласия Microsoft Entra и авторизация SharePoint по-прежнему применяются.

Пример 4

Enable-SPOSiteRestrictedAppAccessControl -Identity "https://contoso.sharepoint.com/sites/Finance" -Confirm:$false

В этом примере принудительное применение включается без интерактивного запроса подтверждения для использования в автоматизации. Использование -Confirm:$false не обходит проверку, авторизацию, аудит или защиту от собственного производителя.

Параметры

-Confirm

Применимо: SharePoint Online

Перед запуском командлет запросит подтверждение. Этот командлет использует ConfirmImpact.High, поэтому по умолчанию выдает запросы. Используется -Confirm:$false для подавления запроса в автоматизации.

Свойства параметров

Тип:System.Management.Automation.SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Identity

Применимо: SharePoint Online

Указывает сайт для включения. Укажите URL-адрес сайта или идентификатор сайта.

Свойства параметров

Тип:System.String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-WhatIf

Применимо: SharePoint Online

Показывает, что произойдет при запуске этого командлета. Командлет не запущен.

Свойства параметров

Тип:System.Management.Automation.SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.

Входные данные

None

Выходные данные

None

Этот командлет не возвращает объект. Используйте Get-SPOSiteRestrictedAppAccessControl для чтения результирующей политики.

Примечания

  • Этот командлет завершается сбоем, если на сайте не настроен режим. Установите режим до AllowDeny включения политики.
  • Принудительное использование прав на сайте включается только этим командлетом. Изменения режима и списка сохраняют текущее состояние включения.
  • Пустой список активных разрешений приводит к тому, что политика сайта запрещает все управляемые сторонние и агентские приложения. Перед включением сайта просмотрите активный список Get-SPOSiteRestrictedAppAccessControl .
  • В Deny этом режиме приложения, представленные в списке запрещений, запрещены политикой сайта. Все остальные управляемые приложения проходят проверку ограничений приложений.
  • Переключение клиента ограничивает все принудительное применение к сайту, поэтому политика сайта не действует, пока переключатель клиента отключен. Список запрещенных клиентов не может быть переопределен списком разрешенных сайтов.
  • Ограничения приложений никогда не предоставляют разрешения. Запрос все равно должен пройти существующую авторизацию SharePoint.
  • Этот командлет поддерживает -WhatIf и -Confirm с ConfirmImpact.Highпомощью . -Confirm:$false разрешен для автоматизации и не обходит проверку, авторизацию, аудит или защиту от собственных компонентов.