보고서를 기반으로 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 cmdlet, Microsoft 보고서에서 빠지는 항목, 그리고 실행을 테스트하고 기록하고 확인하는 방법을 다룹니다. 가상의 수치를 사용한 예시로 전체 과정을 살펴봅니다.
핵심 포인트
- SharePoint 권한을 일괄 수정하려면 보고서에서 시작해야 합니다. 스크립트의 모든 변경은 사람이 유지, 제거 또는 재설정으로 표시한 행 하나로 추적될 수 있어야 합니다.
- Microsoft의 사이트 공유 보고서는 모든 고유 파일, 사용자, 권한 및 링크를 나열하지만, Anyone 링크와 SharePoint 그룹 안의 개별 사용자는 제외합니다.
- 대부분의 일괄 수정은 세 가지 PnP PowerShell cmdlet으로 처리할 수 있습니다. Remove-PnPGroupMember, Set-PnPListItemPermission, Remove-PnPSiteCollectionAdmin입니다.
- 항목을 상위 목록에서 권한을 상속하도록 재설정하면 고유 권한이 제거되며, 권한이 점점 늘어나는 문제를 해결하는 가장 깔끔한 방법인 경우가 많습니다.
- 스크립트를 사이트 하나에서 테스트하고, 모든 변경 내용을 로그로 남기고, 이후 보고서를 한 번 더 실행해 문제가 해결되었는지 확인하세요.
항목을 하나씩 수정하는 방식이 실패하는 이유
대부분의 SharePoint 권한 문제는 서서히 쌓입니다. 누군가 동료와 파일 하나를 공유합니다. 또 다른 누군가는 이미 끝난 프로젝트를 위해 폴더의 권한 상속을 끊습니다. 몇 년이 지나면 일부 문서 라이브러리에는 고유 권한이 설정된 항목이 수백 개가 되고, 그중 무엇이 아직 중요한지 아무도 말하지 못합니다.
이런 문제를 하나씩 해결하면 세 가지 문제가 생깁니다. 시간이 오래 걸리고, 항목을 놓치기 쉬우며, 무엇을 변경했는지 기록이 남지 않아 실수를 되돌리거나 감사 담당자에게 설명하기 어렵습니다.
일괄 수정은 순서를 뒤집습니다. 먼저 보고서에서 사실을 수집합니다. 그다음 사람이 결정합니다. 그제서야 스크립트가 실행되며, 결정이 기록된 행에만 작업을 수행합니다. 이렇게 하면 자동화의 속도와 수동 검토의 신중함을 함께 얻을 수 있습니다.
SharePoint 권한을 일괄 수정하는 방법: 다섯 단계
다음 단계를 순서대로 따르세요.
- 사실 내보내기. 사이트에 대한 보고서를 만듭니다. Microsoft의 파일 및 폴더 공유 보고서 가이드에 따르면, 사이트 관리자는 설정, 사이트 사용량의 외부 사용자와 공유됨 섹션에서 보고서 실행을 선택해 보고서를 실행합니다. CSV 파일을 저장할 위치를 선택할 수 있으며, 완료되면 이메일을 받게 됩니다.
- 결정 열 추가하기. Excel에서 CSV를 열고 허용된 값 세 가지(유지, 제거, 재설정)를 입력하는 열을 추가합니다. 사유를 적는 열도 하나 더 추가하세요. 직접 판단할 수 없는 행은 사이트 소유자에게 검토를 요청하세요.
- 결정을 기준으로 스크립트 작성하기.
Import-Csv로 파일을 읽고, 행을 순회하면서 결정 유형마다 cmdlet을 하나씩 실행합니다. 결정이 없는 행은 모두 건너뛰세요. - 먼저 테스트 사이트 또는 라이브러리 하나에서 확인합니다. 스크립트를 테스트 사이트나 단일 라이브러리에서 먼저 실행합니다. 결과를 예상과 비교합니다.
- 두 번째 보고서로 확인합니다. 실제 실행 후 보고서를 다시 생성합니다. 제거한 행은 사라져야 하고, 유지한 행은 변경되지 않아야 합니다.
2단계를 건너뛰지 마십시오. 스크립트의 안전성은 읽어 들이는 목록에 달려 있습니다.
권한을 재설정하기 전에 권한 상속 방식 이해하기
Microsoft 지원 페이지 SharePoint 목록 또는 라이브러리의 권한 사용자 지정에서는 폴더, 목록, 문서가 일반적으로 이를 포함하는 사이트로부터 권한을 상속한다고 설명합니다. 목록이나 라이브러리에 고유한 권한을 부여하려면 소유자가 "권한 상속 중지"를 선택하며, 그 아래 항목은 새 설정을 상속합니다. 되돌리려면 권한 탭에서 "고유 권한 삭제"를 사용할 수 있으며, 이는 설정한 사용자 지정 권한을 제거합니다.
같은 페이지에서 대량 작업과 관련해 중요한 경고 세 가지를 제시합니다.
- 10만 개 항목 제한. 항목이 10만 개를 넘는 목록, 라이브러리 또는 폴더에서는 상속을 중단하거나 복원할 수 없습니다. 대형 라이브러리의 개별 파일은 여전히 상속을 중단할 수 있습니다.
- 사용자 제거는 하위 항목에도 적용됩니다. 사용자나 그룹을 제거하면 하위 항목에서도 제거되며, 상속이 중단된 항목도 예외가 아닙니다. 이를 되돌릴 수 없습니다. 제거를 실행하기 전에 로그를 꼭 확인하십시오.
- 제한된 액세스는 그대로 남습니다. 항목 하나만 공유받은 사람은 사이트에 대한 제한된 액세스 권한을 얻으며, 항목 공유를 해제해도 이 권한은 사라지지 않습니다.
Microsoft는 SharePoint 그룹 사용을 권장하며, 항목 수준 권한은 합리적인 범위에서 지원된다고 밝히고 있습니다. 저희의 경험상 원칙은 개별 사용자가 아닌 그룹을 통해 액세스를 부여하는 것입니다. 그래야 사이트 권한을 쉽게 파악할 수 있고, 수정해야 할 고유 권한도 줄어듭니다.
어떤 cmdlet으로 어떤 문제를 해결할 수 있을까요?
PnP PowerShell에는 대부분의 대량 수정 작업을 위한 cmdlet이 있습니다. 가장 자주 쓰이는 세 가지는 다음과 같습니다.
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 그룹 내 개별 사용자. 그룹은 표시되지만 그룹 멤버는 표시되지 않습니다.
- 이메일로 전송되었으나 한 번도 클릭되지 않은 링크.
- 익명(anonymous) 링크 누구나 사용 가능한 링크.
이는 실제로 중요한 결과를 낳습니다. 목표가 특정 사용자가 어디에 액세스할 수 있는지 찾는 것이라면, 보고서에는 그룹이 표시되므로 그룹의 멤버를 별도로 확인해야 합니다. 목표가 공개 공유를 제거하는 것이라면, 보고서에는 Anyone 링크가 전혀 나열되지 않으므로 SharePoint 관리 센터의 Data access governance 보고서처럼 다른 소스가 필요합니다. Microsoft에 따르면 이 보고서들은 SharePoint Advanced Management가 필요합니다.
SharePoint Online의 단일 SharePoint 사이트라면, 항목을 변경하기 전에 사이트 설정에서 사이트 권한과 사용 중인 권한 수준도 검토하십시오. 그다음 한 사이트만이 아니라 테넌트 전체에 대한 SharePoint reporting 옵션을 확인하십시오. 사이트별 CSV는 수백 개의 사이트로는 확장되지 않습니다.
Microsoft 365 그룹에 연결된 사이트의 경우, 그룹 멤버십은 사이트 자체의 그룹이 아니라 그룹을 통해 관리됩니다. 사이트 그룹을 편집하는 스크립트로는 Microsoft 365 그룹에 속한 사용자의 권한을 바로잡을 수 없습니다.
스크립트를 안전하게 실행하기
대량 작업 스크립트는 짧은 시간에 많은 피해를 줄 수 있습니다. 첫 실제 실행 전에 다음 보호 장치를 반드시 포함하십시오.
- 드라이런 스위치를 추가하십시오. 직접 만든 스크립트에
-DryRun매개 변수를 두어, 계획된 각 작업을 출력하되 아무것도 변경하지 않도록 할 수 있습니다. 이 출력을 사이트 소유자와 함께 검토하십시오. - 변경하기 전에 기록하십시오. 각 행에 대해 먼저 이전 상태를 로그에 기록하십시오. 항목 경로, 사용자, 그리고 전체 제어, 편집, 읽기 같은 권한 수준이 포함되어야 합니다. 이 로그가 원래 상태로 되돌리는 방법입니다.
- 배치 단위로 작업하십시오. 50개 항목을 실행하고 확인한 다음 500개를 실행하십시오. 작은 첫 배치는 잘못된 가정을 일찍 발견하게 해 줍니다.
- 원본 보고서를 보관하십시오. 결정 사항이 담긴 CSV와 로그는 사이트 소유자만 열 수 있는 폴더에 저장하십시오. 보고서에는 누가 무엇에 액세스할 수 있는지가 나열되므로, Microsoft도 보고서 자체에 대해 같은 방식을 권장합니다.
- 그룹 멤버십 변경은 별도 실행으로 하십시오. 항목 권한은 한 번의 실행에서, 그룹 멤버십은 다른 실행에서 수정하여 각 유형의 변경을 개별적으로 확인할 수 있도록 하십시오.
예시: 문서 라이브러리 하나 정리하기
아래 수치는 가상의 값입니다.
한 프로젝트 사이트에 문서 라이브러리가 하나 있습니다. 보고서에는 620개 행이 있습니다. 정렬 후 관리자와 사이트 소유자가 각 행을 표시합니다.
- 410개 행: 유지. 일반적인 그룹 기반 권한입니다.
- 150개 행: 재설정. 이전 공유에서 생긴 고유 권한이 설정된 개별 파일입니다.
- 40개 행: 제거. 전직 계약자에게 직접 액세스를 부여하고 있습니다.
- 20개 행: 불명확. 질문과 함께 소유자에게 돌려보냅니다.
관리자는 두 개의 분기를 가진 스크립트를 작성합니다. 재설정 분기는 각 파일에 대해 -InheritPermissions와 함께 Set-PnPListItemPermission을 실행합니다. 제거 분기는 계약자가 속한 그룹에서 Remove-PnPGroupMember를 실행합니다. 스크립트는 작업마다 한 줄씩 로그를 기록하며, 날짜, 항목, 이전 상태, 새 상태를 포함합니다.
먼저 관리자는 라이브러리 복사본에서 20개 행으로 스크립트를 실행합니다. 결과는 계획과 일치합니다. 전체 실행은 하루 저녁이면 끝납니다. 두 번째 보고서에는 관리자가 예상한 대로 410개와 20개 행이 표시됩니다. 로그는 보고서 옆에 저장되므로 누구나 무슨 일이 있었는지 확인할 수 있습니다.
흔한 실수
- 결정 목록 없이 스크립트를 실행하는 것. 나중에 항목이 왜 변경되었는지 설명할 수 없게 됩니다.
- 고유 권한이 의도된 라이브러리에서 상속을 재설정하는 것. 일부 폴더는 의도적으로 제한되어 있습니다. 이런 폴더는 유지로 표시하십시오.
- 보고서가 완전하다고 믿는 것. 보고서에는 Anyone 링크와 SharePoint 그룹의 멤버가 빠져 있습니다.
- 추가 전에 제거하는 것. 한 사용자를 다른 사용자로 교체할 때는 먼저 추가하십시오.
- 사용자별로 항목마다 액세스를 부여하는 것. 권한은 항목 단위 개별 사용자가 아니라 그룹을 통해 부여하십시오. 그래야 다음 검토가 더 짧아집니다.
- Microsoft 365 그룹을 잊는 것. 사이트를 정리한 뒤에도 그룹 멤버십을 통해 사용자가 액세스를 유지할 수 있습니다.
- 로그도 두 번째 보고서도 없는 것. 이것이 없으면 수정 내용을 증명하거나 되돌릴 수 없습니다.
소프트웨어가 도움이 되는 방식
이미 가지고 있는 도구부터 시작하십시오. 사이트 공유 보고서와 관리 센터 보고서가 사실을 보여 주고, PnP PowerShell이 변경을 수행하며, 스프레드시트가 결정 사항과 로그를 보관합니다.
일부 서드파티 도구는 리포트 작성과 수정을 하나의 화면에서 함께 제공합니다. 한 예로 Cognillo의 SharePoint Essentials Toolkit이 있습니다. 공급업체 제품 페이지에 따르면 이 도구는 사이트, 폴더, 항목별 권한 리포트를 제공하고, 특정 사용자가 접근할 수 있는 모든 항목을 보여주며, 한 사용자를 다른 사용자로 교체하고, 리포트에서 권한과 공유 링크를 바로 수정할 수 있습니다. 공급업체는 리포트와 작업을 예약하고 내보낼 수 있다고도 설명합니다. 이는 공급업체의 주장이며 M365.FM에서 직접 검증하지는 않았습니다. 위에서 설명한 수동 방식은 이러한 도구 없이도 작동합니다.
공개: Cognillo는 M365.FM의 후원사입니다.
다음 단계
권한 문제가 알려진 사이트를 하나 골라 공유 리포트를 실행하고, CSV에 결정 열을 추가하십시오. 그다음 이 목록을 사용해 먼저 테스트 라이브러리에서 SharePoint 권한을 일괄 수정하고, 작업 로그를 남기십시오.