M365Con 2027 – бесплатная онлайн-конференция · 11–22 Jan 2027 · 120 sessions→ m365con.net

Блог · Mirko Peters

Массовое исправление разрешений SharePoint по отчету, а не по каждому элементу

Disclosure: Cognillo sponsors M365.FM. This page describes the company factually; paid partnerships and links are labelled as advertising.

By · · Updated

Массовое исправление разрешений SharePoint: выгрузите отчет, отметьте каждую строку как «сохранить», «удалить» или «сбросить», протестируйте скрипт PnP PowerShell сначала на одном сайте, а затем проверьте результат.

Automatically translated with AI from the original post. Read the English original

Чтобы массово исправить разрешения SharePoint, выгрузите отчет о том, кто имеет доступ, отметьте каждую строку как «сохранить», «удалить» или «сбросить», а затем запустите скрипт, который читает ваши решения. Это руководство предназначено для администраторов SharePoint, которым приходится работать с сотнями элементов с уникальными разрешениями и которые не хотят кликать по каждому из них отдельно. Вы увидите, как составить список решений, какие командлеты PnP PowerShell выполняют работу, что не включает отчет Microsoft, а также как протестировать, журналировать и проверить запуск. Наглядный пример с вымышленными цифрами показывает полный цикл.

Ключевые выводы

  • Чтобы массово исправить разрешения SharePoint, начните с отчета: каждое изменение в скрипте должно восходить к одной строке, которую человек отметил как «сохранить», «удалить» или «сбросить».
  • Отчет Microsoft о совместном доступе к сайту перечисляет каждый уникальный файл, пользователя, разрешение и ссылку, но не включает ссылки «Anyone» и отдельных людей внутри групп SharePoint.
  • Три командлета PnP PowerShell покрывают большинство массовых исправлений: Remove-PnPGroupMember, Set-PnPListItemPermission и Remove-PnPSiteCollectionAdmin.
  • Сброс элемента к наследованию разрешений от его списка удаляет его уникальные разрешения и часто является самым чистым решением проблемы разрастания разрешений.
  • Протестируйте скрипт на одном сайте, ведите журнал каждого изменения и запустите повторный отчет после работы, чтобы подтвердить, что проблема устранена.

Почему исправление по одному элементу не работает

Большинство проблем с разрешениями SharePoint накапливаются постепенно. Кто-то делится одним файлом с коллегой. Кто-то другой отключает наследование разрешений для папки в рамках проекта, который давно завершился. Через несколько лет в некоторых библиотеках документов оказываются сотни элементов с уникальными разрешениями, и никто не может сказать, какие из них еще важны.

Исправлять их по одному неудобно по трем причинам. Это медленно. Легко пропустить элементы. И не остается записи о том, что вы изменили, поэтому вы не можете отменить ошибку или ответить аудитору.

Массовое исправление меняет порядок действий. Сначала вы собираете факты в отчете. Затем человек принимает решение. Только после этого скрипт действует, и делает он это только для строк, у которых есть решение. Так сохраняется скорость автоматизации и аккуратность ручной проверки.

Как массово исправить разрешения SharePoint: пять шагов

Выполняйте эти шаги по порядку.

  1. Выгрузите факты. Создайте отчет для сайта. В руководстве Microsoft по отчету о совместном доступе к файлам и папкам сказано, что администратор сайта запускает его из раздела Параметры, Использование сайта, в разделе Общий доступ для внешних пользователей, кнопкой Запустить отчет. Вы выбираете, где сохранить CSV-файл, и получаете письмо по завершении.
  2. Добавьте столбец решений. Откройте CSV-файл в Excel и добавьте столбец с тремя допустимыми значениями: сохранить, удалить, сбросить. Добавьте второй столбец для причины. Попросите владельца сайта проверить строки, которые вы не можете оценить самостоятельно.
  3. Напишите скрипт вокруг решений. Прочитайте файл с помощью Import-Csv, переберите строки и выполните один командлет для каждого типа решения. Пропускайте каждую строку без решения.
  4. Сначала проверьте на одном сайте, затем на одной библиотеке. Сначала запустите скрипт на тестовом сайте или в одной библиотеке. Сравните результат с тем, что вы ожидали.
  5. Проверьте вторым отчётом. После реального запуска создайте отчёт заново. Строки, которые вы удалили, должны исчезнуть, а строки, которые вы оставили, должны остаться без изменений.

Не пропускайте шаг 2. Скрипт безопасен ровно настолько, насколько безопасен список, который он читает.

Как работает наследование разрешений до того, как вы что-либо сбросите

На странице поддержки Microsoft, посвящённой настройке разрешений для списка или библиотеки SharePoint, объясняется, что папки, списки и документы обычно наследуют разрешения от содержащего их сайта. Чтобы задать списку или библиотеке собственные разрешения, владелец выбирает «Прекратить наследование разрешений», и элементы, находящиеся внутри, затем наследуют новые настройки. Чтобы вернуться назад, на вкладке «Разрешения» предусмотрена команда «Удалить уникальные разрешения», которая убирает заданные вами особые разрешения.

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

  • Ограничение в 100 000 элементов. Нельзя прервать или восстановить наследование для списка, библиотеки или папки, которые содержат более 100 000 элементов. Наследование при этом может быть прервано для отдельного файла в большой библиотеке.
  • Удаление пользователя затрагивает дочерние элементы. Удаление пользователя или группы удаляет их и из дочерних элементов, в том числе тех, где наследование прервано, и восстановить их нельзя. Прочитайте журнал, прежде чем запускать удаление.
  • Ограниченный доступ сохраняется. Человек, которому был предоставлен доступ только к одному элементу, получает ограниченный доступ к сайту, и отмена общего доступа к элементу этого не отменяет.

Microsoft рекомендует группы SharePoint и считает разрешения на уровне элементов допустимыми при разумном использовании. Наше собственное практическое правило: назначать доступ через группу, а не отдельным пользователям, чтобы разрешения сайта оставались понятными, а уникальных разрешений, которые нужно исправлять, оставалось меньше.

Какая команда решает какую проблему?

Для большинства массовых исправлений есть командлеты PnP PowerShell. Эти три встречаются чаще всего.

Удалить человека из группы SharePoint. В справке по Remove-PnPGroupMember приведён синтаксис: Remove-PnPGroupMember -LoginName user@company.com -Group 'Marketing Site Members'. Используйте её для проблем с членством в группах, например когда уволившийся сотрудник всё ещё состоит в группе «Члены».

Изменить или сбросить разрешения для элемента. В справке по Set-PnPListItemPermission перечислены следующие параметры:

  • -AddRole и -RemoveRole добавляют или удаляют уровень разрешений для пользователя или группы у одного элемента. Используйте Get-PnPRoleDefinition, чтобы увидеть доступные роли.
  • -ClearExisting удаляет все существующие разрешения элемента перед добавлением новой роли.
  • -InheritPermissions сбрасывает элемент так, что он наследует разрешения от своего списка, и удаляет его уникальные разрешения.
  • -SystemUpdate изменяет разрешения без создания новой версии и без запуска Power Automate.

Сброс часто оказывается самым чистым решением. Если у элемента есть уникальные разрешения только потому, что кто-то однажды открыл к нему общий доступ, сброс возвращает его к правилам библиотеки.

Удалить администратора коллекции сайтов. В справке по Remove-PnPSiteCollectionAdmin приведён пример: Remove-PnPSiteCollectionAdmin -Owners "user@contoso.onmicrosoft.com". Администраторы, которых вы не указали, сохраняют доступ. Можно передать и список пользователей.

Чтобы заменить одного пользователя другим, выполните два шага: сначала добавьте нового человека туда, где у старого был доступ, затем удалите старого. Сначала выполните добавление, чтобы никто не потерял доступ в промежутке.

Чего не показывает отчёт

Отчёт — это отправная точка, а не полная картина. На странице Microsoft об отчёте по общему доступу указано, что не входит в CSV-файл:

  • Отдельные пользователи внутри групп SharePoint. Группа отображается, но её участники — нет.
  • Ссылки, которые были отправлены по электронной почте, но ни разу не открыты.
  • Ссылки для анонимных пользователей.

Это имеет реальные последствия. Если ваша цель — выяснить, где у человека есть доступ, в отчёте будет указана группа, поэтому состав группы нужно проверить отдельно. Если ваша цель — убрать публичный доступ, в отчёте не будет ни одной ссылки Anyone, поэтому нужен другой источник, например отчёты Data access governance в центре администрирования SharePoint. По словам Microsoft, для них требуется SharePoint Advanced Management.

Для одного сайта SharePoint в SharePoint Online перед тем, как менять элементы, проверьте также разрешения сайта и уровни разрешений, которые используются, в разделе «Параметры сайта». Затем изучите возможности отчётности SharePoint для всего клиента, а не только одного сайта. CSV-файл по каждому сайту не масштабируется на сотни сайтов.

Для сайтов, подключённых к группам Microsoft 365, членство в группе управляется через саму группу, а не через группы самого сайта. Скрипт, который редактирует группы сайта, не исправит ситуацию с человеком, который состоит в группе Microsoft 365.

Сделайте скрипт безопасным для запуска

Массовый скрипт может за короткое время нанести много вреда. Перед первым реальным запуском добавьте такие защитные меры:

  1. Добавьте переключатель пробного запуска. Ваш скрипт может принимать параметр -DryRun, который выводит каждое запланированное действие и ничего не меняет. Проверьте этот вывод вместе с владельцем сайта.
  2. Записывайте в журнал до изменения. Для каждой строки сначала запишите прежнее состояние: путь к элементу, пользователя и уровень разрешений, например «Полный контроль», «Редактирование» или «Чтение». Этот журнал — ваш способ вернуть всё назад.
  3. Работайте пакетами. Сначала обработайте 50 элементов, проверьте результат, а затем запускайте следующие 500. Небольшой первый пакет помогает рано выявить ошибочное предположение.
  4. Храните исходный отчёт. Сохраните CSV-файл с вашими решениями и журнал в папке, которую могут открывать только владельцы сайта. Microsoft рекомендует делать то же самое и с самим отчётом, поскольку в нём перечислено, кто и к чему имеет доступ.
  5. Меняйте членство в группах отдельным запуском. Исправляйте разрешения элементов в одном запуске, а членство в группах — в другом, чтобы проверять каждый тип изменений отдельно.

Пример: очистка одной библиотеки документов

Цифры условные.

У проектного сайта есть одна библиотека документов. В отчёте 620 строк. После сортировки администратор и владелец сайта размечают их:

  • 410 строк: сохранить. Это обычные разрешения на основе групп.
  • 150 строк: сбросить. Это отдельные файлы с уникальными разрешениями, оставшимися от старых общих доступов.
  • 40 строк: удалить. Они дают бывшему подрядчику прямой доступ.
  • 20 строк: неясно. Их возвращают владельцу с вопросом.

Администратор пишет скрипт с двумя ветками. Ветка сброса для каждого файла выполняет Set-PnPListItemPermission с параметром -InheritPermissions. Ветка удаления выполняет Remove-PnPGroupMember для подрядчика в группах, где он встречается. Скрипт записывает одну строку журнала на каждое действие: дату, элемент, прежнее состояние и новое состояние.

Сначала администратор запускает скрипт на копии библиотеки с 20 строками. Результат совпадает с планом. Полный запуск занимает один вечер. Второй отчёт показывает 410 плюс 20 строк, что и ожидал администратор. Журнал сохраняется рядом с отчётом, поэтому любой может увидеть, что произошло.

Распространённые ошибки

  • Запуск скрипта без списка решений. Позже вы не сможете объяснить, почему элемент был изменён.
  • Сброс наследования в библиотеке, где уникальные разрешения нужны. Некоторые папки намеренно ограничены. Отметьте их как «сохранить».
  • Доверие к отчёту как к полному. В нём не отображаются ссылки Anyone и участники групп SharePoint.
  • Удаление до добавления. Когда вы заменяете одного пользователя другим, сначала добавьте нового.
  • Выдача доступа поштучно. Назначайте разрешения через группу, а не отдельному пользователю на каждый элемент, чтобы следующая проверка занимала меньше времени.
  • Забытая группа Microsoft 365. Человек может сохранить доступ через членство в группе даже после очистки сайта.
  • Нет журнала и второго отчёта. Без них вы не сможете подтвердить исправление или отменить его.

Как может помочь программное обеспечение

Начните с инструментов, которые у вас уже есть. Отчёт об общем доступе сайта и отчёты центра администрирования дают факты. PnP PowerShell вносит изменения, а таблица хранит решения и журнал.

Некоторые сторонние инструменты объединяют отчёты и исправления на одном экране. Один из примеров — SharePoint Essentials Toolkit от Cognillo. По данным страницы продукта на сайте поставщика, он формирует отчёты о разрешениях для сайтов, папок и элементов, показывает всё, к чему имеет доступ один пользователь, позволяет заменить одного пользователя другим и исправлять разрешения и ссылки общего доступа прямо из отчётов. Поставщик также заявляет, что отчёты и задачи можно планировать и экспортировать. Это утверждения поставщика, которые M365.FM не проверяла. Ручной способ, описанный выше, работает и без этих инструментов.

Раскрытие информации: Cognillo спонсирует M365.FM.

Следующий шаг

Выберите один сайт с известной проблемой разрешений, запустите отчёт об общем доступе и добавьте в CSV-файл колонку «Решение». Затем используйте этот список, чтобы массово исправить разрешения SharePoint сначала в тестовой библиотеке, и ведите журнал изменений.

Entities in this article

SharePoint permissions SharePoint reporting SharePoint Essentials Toolkit PnP PowerShell

Related articles

RSS