Set-SPOSiteRestrictedAppAccessControlMode

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

Устанавливает активный режим политики ограничений приложений на уровне сайта на Allow или Deny, сохраняя включение сайтов и оба списка.

Синтаксис

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

Set-SPOSiteRestrictedAppAccessControlMode
    [-Identity] <String>
    -Mode <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Описание

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

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

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

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

Оба списка всегда хранятся и могут управляться независимо от того, какой режим активен. Только список, выбранный в активном режиме, участвует в принудительном применении среды выполнения. Этот список сохраняется для будущих изменений режима и не влияет на время выполнения. Перед включением политики сайта необходимо явным образом настроить режим.

Так как переключатель режима может изменить эффективное решение для каждого управляемого приложения на сайте, командлет отобразит предупреждение перед выполнением изменения. В предупреждении указывается текущий режим, целевой режим, размер нового активного сохраненного списка и новое решение по умолчанию. Также четко указано, что оба списка сохраняются. Затем командлет запросит подтверждение. Используется -WhatIf для отображения того же воздействия без изменения политики.

Конфигурация и включение являются ортогональными: изменение режима никогда не включает принудительное применение. Принудительное применение прав для сайтов включается только при использовании Enable-SPOSiteRestrictedAppAccessControl, поэтому вы можете указать режим и списки, а затем явно включить сайт. Единственная комбинация, которую серверная часть отклоняет, включена с mode None.

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

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

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

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

Примеры

Пример 1

Set-SPOSiteRestrictedAppAccessControlMode -Identity https://contoso.sharepoint.com/sites/Finance -Mode Allow

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

Пример 2

Set-SPOSiteRestrictedAppAccessControlMode -Identity https://contoso.sharepoint.com/sites/Finance -Mode Deny -WhatIf

В этом примере показано влияние переключения сайта "Финансы" на Deny, включая текущий режим, целевой режим, размер нового активного списка отказов и новое решение по умолчанию, без изменения политики.

Пример 3

Set-SPOSiteRestrictedAppAccessControlMode -Identity 8a1e30f6-2f52-4b9e-9d1b-2e9f6c1d40aa -Mode Deny -Confirm:$false

В этом примере сайт, определенный по его идентификатору, переключается на Deny беззапросное переключение для использования в автоматизации. Подавление запроса не обходит проверку, авторизацию, аудит или защиту от угроз.

Пример 4

Set-SPOSiteRestrictedAppAccessControlMode -Identity https://contoso.sharepoint.com/sites/Finance -Mode Allow
Enable-SPOSiteRestrictedAppAccessControl -Identity https://contoso.sharepoint.com/sites/Finance

В этом примере сначала можно сначала проверить режим, а затем явно включить принудительное применение. Изменение режима никогда не включает принудительное применение само по себе.

Параметры

-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:0
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Mode

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

Указывает активный режим политики сайта. Допустимые значения — Allow и Deny.

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

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

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

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

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

-WhatIf

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

Показывает, что произойдет при запуске этого командлета. Командлет не запущен. -WhatIf Отображает то же влияние переключения режимов, что и предупреждение подтверждения, без изменения политики.

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

Тип: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.

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

System.String

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

None

Примечания

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