Массовое исправление разрешений SharePoint по отчету, а не по каждому элементу
Disclosure: Cognillo sponsors M365.FM. This page describes the company factually; paid partnerships and links are labelled as advertising.
By Mirko Peters · · 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: пять шагов
Выполняйте эти шаги по порядку.
- Выгрузите факты. Создайте отчет для сайта. В руководстве Microsoft по отчету о совместном доступе к файлам и папкам сказано, что администратор сайта запускает его из раздела Параметры, Использование сайта, в разделе Общий доступ для внешних пользователей, кнопкой Запустить отчет. Вы выбираете, где сохранить CSV-файл, и получаете письмо по завершении.
- Добавьте столбец решений. Откройте CSV-файл в Excel и добавьте столбец с тремя допустимыми значениями: сохранить, удалить, сбросить. Добавьте второй столбец для причины. Попросите владельца сайта проверить строки, которые вы не можете оценить самостоятельно.
- Напишите скрипт вокруг решений. Прочитайте файл с помощью
Import-Csv, переберите строки и выполните один командлет для каждого типа решения. Пропускайте каждую строку без решения. - Сначала проверьте на одном сайте, затем на одной библиотеке. Сначала запустите скрипт на тестовом сайте или в одной библиотеке. Сравните результат с тем, что вы ожидали.
- Проверьте вторым отчётом. После реального запуска создайте отчёт заново. Строки, которые вы удалили, должны исчезнуть, а строки, которые вы оставили, должны остаться без изменений.
Не пропускайте шаг 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.
Сделайте скрипт безопасным для запуска
Массовый скрипт может за короткое время нанести много вреда. Перед первым реальным запуском добавьте такие защитные меры:
- Добавьте переключатель пробного запуска. Ваш скрипт может принимать параметр
-DryRun, который выводит каждое запланированное действие и ничего не меняет. Проверьте этот вывод вместе с владельцем сайта. - Записывайте в журнал до изменения. Для каждой строки сначала запишите прежнее состояние: путь к элементу, пользователя и уровень разрешений, например «Полный контроль», «Редактирование» или «Чтение». Этот журнал — ваш способ вернуть всё назад.
- Работайте пакетами. Сначала обработайте 50 элементов, проверьте результат, а затем запускайте следующие 500. Небольшой первый пакет помогает рано выявить ошибочное предположение.
- Храните исходный отчёт. Сохраните CSV-файл с вашими решениями и журнал в папке, которую могут открывать только владельцы сайта. Microsoft рекомендует делать то же самое и с самим отчётом, поскольку в нём перечислено, кто и к чему имеет доступ.
- Меняйте членство в группах отдельным запуском. Исправляйте разрешения элементов в одном запуске, а членство в группах — в другом, чтобы проверять каждый тип изменений отдельно.
Пример: очистка одной библиотеки документов
Цифры условные.
У проектного сайта есть одна библиотека документов. В отчёте 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 сначала в тестовой библиотеке, и ведите журнал изменений.