Виправлення дозволів 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, які мають справу із сотнями елементів з унікальними дозволами і не хочуть клацати по кожному окремо. Ви побачите, як побудувати список рішень, які cmdlet PnP PowerShell виконують роботу, чого не охоплює звіт Microsoft, а також як тестувати, журналювати й перевіряти запуск. Повний цикл показано на прикладі з вигаданими цифрами.
Головне
- Щоб масово виправити дозволи SharePoint, почніть зі звіту: кожна зміна в скрипті має відповідати одному рядку, який людина позначила як «зберегти», «видалити» або «скинути».
- Звіт Microsoft про спільний доступ до сайту містить кожен унікальний файл, користувача, дозвіл і посилання, але не включає посилання Anyone та окремих людей у групах SharePoint.
- Три cmdlet PnP PowerShell покривають більшість масових виправлень: Remove-PnPGroupMember, Set-PnPListItemPermission і Remove-PnPSiteCollectionAdmin.
- Скидання елемента до успадкування дозволів від його списку видаляє його унікальні дозволи і часто є найчистішим способом усунути накопичення зайвих доступів.
- Протестуйте скрипт на одному сайті, ведіть журнал кожної зміни, а потім запустіть другий звіт, щоб довести, що проблему усунуто.
Чому виправлення по одному елементу не працює
Більшість проблем із дозволами SharePoint накопичуються поступово. Хтось надає доступ до одного файлу колезі. Хтось інший вирішує розірвати успадкування дозволів для папки проєкту, який давно завершився. Через кілька років у деяких бібліотеках документів опиняються сотні елементів з унікальними дозволами, і ніхто не може сказати, які з них ще мають значення.
Виправляти це по одному має три недоліки. Це повільно. Легко пропустити елементи. І не залишається запису про те, що ви змінили, тож ви не можете відкотити помилку або відповісти аудитору.
Масове виправлення змінює порядок. Спочатку ви збираєте факти у звіті. Потім рішення ухвалює людина. І лише після цього скрипт діє, причому тільки щодо рядків, які мають рішення. Так зберігається швидкість автоматизації та ретельність ручної перевірки.
Як масово виправити дозволи SharePoint: п'ять кроків
Виконуйте ці кроки по порядку.
- Експортуйте факти. Створіть звіт для сайту. У посібнику Microsoft щодо звіту про спільний доступ до файлів і папок сказано, що адміністратор сайту запускає його через Параметри, Використання сайту, у розділі Спільний доступ зовнішнім користувачам, кнопкою Запустити звіт. Ви обираєте, де зберегти CSV-файл, і отримуєте лист, коли звіт готовий.
- Додайте колонку рішень. Відкрийте CSV-файл в Excel і додайте колонку з трьома допустимими значеннями: «зберегти», «видалити», «скинути». Додайте другу колонку для причини. Попросіть власника сайту переглянути рядки, які ви не можете оцінити самостійно.
- Напишіть скрипт навколо рішень. Зчитайте файл за допомогою
Import-Csv, переберіть рядки та запускайте один cmdlet для кожного типу рішення. Пропускайте кожен рядок без рішення. - Спершу перевірте на одному сайті, потім на одній бібліотеці. Запустіть скрипт спочатку на тестовому сайті або на окремій бібліотеці. Порівняйте результат з тим, що ви очікували.
- Перевірте за допомогою другого звіту. Після реального запуску створіть звіт знову. Рядки, які ви видалили, мають зникнути, а рядки, які ви залишили, мають бути незмінними.
Не пропускайте крок 2. Скрипт є безпечним лише настільки, наскільки безпечний список, який він читає.
Як працює успадкування дозволів перед скиданням будь-чого
Сторінка підтримки Microsoft про налаштування дозволів для списку або бібліотеки SharePoint пояснює, що папки, списки та документи зазвичай успадковують дозволи від сайту, у якому вони містяться. Щоб надати списку або бібліотеці власні дозволи, власник обирає «Припинити успадкування дозволів», і елементи всередині них потім успадковують нові параметри. Щоб повернутися назад, на вкладці «Дозволи» є команда «Видалити унікальні дозволи», яка прибирає налаштовані вами власні дозволи.
Три застереження з тієї самої сторінки важливі для масової роботи:
- Ліміт у 100 000 елементів. Ви не можете перервати або відновити успадкування для списку, бібліотеки чи папки, що містить понад 100 000 елементів. Окремий файл у великій бібліотеці при цьому все ще може мати перерване успадкування.
- Видалення користувача зачіпає вкладені елементи. Видалення користувача або групи також прибирає їх із дочірніх елементів, зокрема з тих, де успадкування перервано, і відновити їх неможливо. Перед видаленням перегляньте журнал.
- Обмежений доступ залишається. Особа, з якою було поділено лише один елемент, отримує обмежений доступ до сайту, і скасування спільного доступу до елемента цього не прибирає.
Microsoft рекомендує групи SharePoint і називає дозволи на рівні елементів підтримуваними за розумного використання. Наше власне правило: надавати доступ через групу, а не окремим користувачам, щоб дозволи сайту залишалися зрозумілими, а унікальних дозволів, які доведеться виправляти, було менше.
Яка команда виправляє яку проблему?
PnP PowerShell має командлети для більшості масових виправлень. Ці три трапляються найчастіше.
Видаліть особу з групи SharePoint. Довідка про Remove-PnPGroupMember показує синтаксис: Remove-PnPGroupMember -LoginName user@company.com -Group 'Marketing Site Members'. Використовуйте її для проблем із членством у групах, наприклад, коли співробітник, що звільнився, усе ще перебуває в групі 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», тому знадобиться інше джерело, наприклад звіти про керування доступом до даних у центрі адміністрування SharePoint. За даними Microsoft, для них потрібна ліцензія SharePoint Advanced Management.
Для окремого сайту 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 спочатку в тестовій бібліотеці, і зберігайте журнал змін.