PowerShell로 Microsoft Purview 역할 그룹 보고서를 생성하는 방법

By Mirko Peters · 2026-03-06 · Updated 2026-03-24

PowerShell을 사용해 Microsoft Purview 역할 그룹 권한 보고서를 만드세요. 이 가이드로 규정 준수, 전자 검색(eDiscovery), Microsoft 365를 감사하세요.

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

Purview에서 역할 그룹을 관리하는 일은 조직의 보안과 규정 준수를 유지하는 데 매우 중요합니다. PowerShell을 활용하면 이 과정을 간소화할 수 있습니다. PowerShell은 작업을 자동화해 시간을 절약해 줍니다. PowerShell을 사용하면 Purview의 역할 그룹 구성원을 정리한 보고서를 손쉽게 생성할 수 있습니다. 이 가이드에서는 Purview에 연결하고 보고서를 효과적으로 만드는 데 필요한 단계를 차근차근 설명합니다.

핵심 요약

보고서를 생성하기 전에 Purview에 대한 관리자 액세스 권한이 있는지 확인하세요. 이 권한은 역할 그룹을 효과적으로 관리하는 데 필수적입니다.
Microsoft Purview에 원활하게 연결하려면 PowerShell 5.1 버전과 필요한 모듈(CAMP 및 AIPService)을 설치하세요.
PowerShell 스크립트를 사용하면 Purview 역할 그룹 보고서 생성을 자동화할 수 있습니다. 이렇게 하면 시간을 절약하고 수작업으로 인한 오류를 줄일 수 있습니다.
규정 준수와 보안을 유지하기 위해 보고서를 정기적으로 예약하세요. 이 과정을 자동화하면 역할 그룹 구성원의 변동 사항을 지속적으로 파악하는 데 도움이 됩니다.
보고서 데이터를 분석해 추세와 잠재적인 보안 위험을 파악하세요. 정기적인 검토를 통해 승인된 사용자만 민감한 정보에 액세스할 수 있도록 보장할 수 있습니다.

Microsoft Purview 역할 그룹 보고서에 관한 놀라운 사실 7가지

Purview 역할 그룹은 프로그래밍 방식으로 나열하고 내보낼 수 있습니다. PowerShell로 포괄적인 Purview 역할 그룹 보고서를 생성하면 한 번의 실행으로 구성원, 할당된 역할, 범위를 모두 파악할 수 있습니다.
역할 그룹 구성원은 Purview UI에서 항상 보이는 것은 아닙니다. 일부 중첩되거나 상속된 구성원은 PowerShell로 조회할 때만 나타나므로, 보고서를 통해 숨겨진 액세스 경로를 확인할 수 있습니다.
감사의 빈틈도 발견할 수 있습니다. PowerShell로 만든 Purview 역할 그룹 보고서는 UI에서 놓치기 쉬운 오래되거나 고아 상태인 권한을 보여 주어, 과도한 권한을 가진 계정을 줄이는 데 도움이 됩니다.
사용자 지정 역할은 보고서에 영향을 줍니다. 사용자 지정 역할이 포함된 역할 그룹은 표준이 아닌 권한 집합을 가질 수 있으며, 스크립트로 만든 보고서만이 이를 실제 권한으로 정확히 해석합니다.
테넌트 간 시나리오도 보고할 수 있습니다. PowerShell 자동화를 사용하면 여러 테넌트의 역할 그룹 보고서를 통합해 거버넌스 및 규정 준수 검토에 활용할 수 있는 표준화된 보기로 정리할 수 있습니다.
시간 기반의 변경 추적도 가능합니다. PowerShell로 Purview 역할 그룹 보고서를 주기적으로 예약 실행하고 결과를 저장하면 과거 변경 내역을 추적하고 예상치 못한 권한 상승을 감지할 수 있습니다.
다른 도구와의 연동도 간단합니다. PowerShell로 생성한 Purview 역할 그룹 보고서를 CSV나 JSON 형식으로 변환해 SIEM, GRC 플랫폼 또는 스프레드시트에 가져와 자동 경고와 분석에 활용할 수 있습니다.

PowerShell 사전 요구 사항

Prerequisites for PowerShell

필수 권한

PowerShell로 Purview에서 보고서를 생성하기 전에 필요한 권한이 있는지 확인하세요. Purview에 대한 관리자 액세스 권한이 필요합니다. 이 권한을 통해 역할 그룹을 효과적으로 보고 관리할 수 있습니다. 이러한 권한이 없으면 스크립트를 실행하거나 데이터를 가져올 때 오류가 발생할 수 있습니다.

PowerShell 설치

스크립트를 실행하려면 컴퓨터에 PowerShell이 설치되어 있어야 합니다. 최소 필요 버전은 5.1입니다. 설치되어 있지 않다면 Microsoft 공식 웹사이트에서 다운로드할 수 있습니다. 또한 Microsoft Purview에 연결하려면 특정 모듈이 필요합니다. 필요한 모듈은 CAMP와 AIPService입니다.

사전 요구 사항을 충족하는지 확인하려면 다음 체크리스트를 참고하세요.

PowerShell 버전: 5.1 버전 이상인지 확인하세요.
모듈: CAMP 및 AIPService 모듈을 설치하세요.
관리자 액세스: Purview에서 관리자 권한이 있는지 확인하세요.

이러한 사전 요구 사항을 충족하면 Purview 역할 그룹 보고서를 생성할 때 원활하게 작업할 수 있습니다.

단계 요약

PowerShell 버전을 확인합니다.
필요한 모듈을 설치합니다.
Purview에서 관리 권한을 확인합니다.

위 단계를 따르면 보고 작업에 PowerShell을 효과적으로 사용할 준비가 됩니다.

Microsoft Purview에 연결

연결 설정

PowerShell로 Microsoft Purview에 연결하려면 다음 단계를 따릅니다.

Azure 구독 확인: 유효한 Azure 구독과 이에 연결된 Microsoft Entra 테넌트가 필요합니다.
Azure 포털에 로그인: Azure 계정 자격 증명을 사용하여 포털에 액세스합니다.
Azure PowerShell 또는 Azure CLI 설치: 클라이언트 컴퓨터에 필요한 도구가 설치되어 있는지 확인합니다.
리소스 그룹 만들기: 리소스 그룹이 없다면 다음 명령을 실행합니다.
```
New-AzResourceGroup -Name myResourceGroup -Location 'East US'
```
Microsoft Purview 계정 만들기 또는 배포: 다음 명령을 사용하여 Purview 계정을 설정합니다.
```
New-AzPurviewAccount
```

위 단계를 따르면 Microsoft Purview에 안전하게 연결할 수 있습니다.

자격 증명 인증

연결을 설정한 후에는 자격 증명을 인증해야 합니다. 방법은 다음과 같습니다.

PowerShell 열기: 컴퓨터에서 PowerShell을 실행합니다.
로그인 명령 실행: 다음 명령을 사용하여 로그인합니다.
```
Connect-AzAccount
```
이 명령을 실행하면 Azure 계정 자격 증명을 입력하라는 메시지가 표시됩니다.
연결 확인: 로그인한 후 다음 명령을 실행하여 Purview 계정에 액세스할 수 있는지 확인합니다.
```
Get-AzPurviewAccount
```

연결 과정에서 문제가 발생하면 다음과 같은 일반적인 오류를 확인해 보십시오.

잘못된 암호: 사용자 이름과 암호를 다시 확인합니다.
PowerShell 액세스: 계정에서 PowerShell 사용이 설정되어 있는지 확인합니다.
네트워크 액세스: Microsoft 365와 통신할 수 있도록 TCP 포트 80이 열려 있는지 확인합니다.
모듈 설치: PowerShellGet 및 PackageManagement 모듈이 모두 설치되어 있는지 확인합니다.

이 단계를 따르면 Microsoft Purview에 성공적으로 연결하고 자격 증명을 인증하여 역할 그룹 보고서를 생성할 준비를 마칠 수 있습니다.

Purview 역할 그룹 보고서 생성

Generate Purview Role Group Report

역할 그룹 멤버십 보고용 PowerShell 스크립트

Purview 역할 그룹 보고서를 생성하려면 다음 PowerShell 스크립트를 사용할 수 있습니다. 이 스크립트는 Microsoft Graph에 연결하고 역할 그룹의 멤버십을 가져옵니다. 보고서를 만들려면 다음 단계를 따르십시오.

Microsoft Graph 연결: 필요한 데이터에 액세스할 수 있도록 필수 범위(scope)를 사용합니다.
Exchange Online 연결: 보안 및 규정 준수 엔드포인트에 액세스할 수 있는지 확인합니다.
역할 그룹 가져오기: Get-RoleGroup cmdlet을 실행하여 테넌트의 모든 역할 그룹을 찾습니다.
멤버십 나열: 각 역할 그룹에 대해 현재 멤버를 확인합니다. Entra ID 개체의 유형을 구분합니다.
PowerShell 목록 업데이트: 각 역할 할당 및 역할 그룹 멤버십의 세부 정보를 저장할 목록을 만듭니다.
고유 식별자 확인: 사용자나 서비스 주체처럼 역할 할당을 보유한 고유 식별자를 찾습니다.
개체 세부 정보 수집: 각 고유 식별자에 대해 부서, 국가 등 추가 세부 정보를 수집합니다.
정보 정렬: 보고를 쉽게 하기 위해 사용자 할당 정보를 개체 유형과 이름별로 정리합니다.
HTML 보고서 생성: 활성 역할 그룹과 각 그룹의 멤버십 세부 정보를 포함하는 HTML 보고서를 만듭니다.

다음은 이 단계들을 구현한 PowerShell 스크립트 예시입니다.

# Connect to Microsoft Graph
Connect-MgGraph -Scopes "Group.Read.All"

# Get role groups
$roleGroups = Get-RoleGroup

# Initialize lists
$roleGroupMemberships = @()

foreach ($group in $roleGroups) {
    $members = Get-RbacGroupMember -GroupId $group.Id
    foreach ($member in $members) {
        $roleGroupMemberships += [PSCustomObject]@{
            RoleGroupName = $group.DisplayName
            MemberName    = $member.DisplayName
            MemberType    = $member.ObjectType
        }
    }
}

# Generate HTML report
$roleGroupMemberships | ConvertTo-Html -Property RoleGroupName, MemberName, MemberType -Title "Purview Role Group Membership Report" | Out-File "PurviewRoleGroupReport.html"

이 스크립트를 사용하면 Purview 역할 그룹의 멤버십에 대한 포괄적인 보고서를 생성하는 데 도움이 됩니다.

출력 데이터 이해하기

PowerShell 스크립트를 실행하면 역할 그룹 멤버십을 자세히 보여주는 HTML 보고서가 생성됩니다. 출력 데이터는 다음과 같이 해석할 수 있습니다:

역할 그룹 이름: 각 역할 그룹의 이름을 표시하는 열입니다.
멤버 이름: 각 역할 그룹에 속한 사용자 또는 서비스 주체의 이름을 나열하는 열입니다.
멤버 유형: 멤버가 사용자, 서비스 주체 또는 다른 유형의 Entra ID 개체인지를 나타냅니다.

이 데이터를 분석하면 조직 내 역할 그룹 멤버십에 대한 인사이트를 얻을 수 있습니다. 이 정보는 적절한 역할 기반 액세스 제어(RBAC)를 보장하고 보안 규정 준수를 유지하는 데 매우 중요합니다.

보고서에 표시되는 멤버십의 정확도는 Purview 환경의 현재 상태에 따라 달라진다는 점을 유의하십시오. 스크립트와 보고서를 정기적으로 업데이트하면 역할 그룹 멤버십의 변경 사항을 계속 파악하는 데 도움이 됩니다.

보고서 작성을 위한 모범 사례

정기 보고서 일정 설정

규정 준수 및 보안을 유지하려면 Purview 역할 그룹에 대한 정기 보고서를 예약하는 것이 좋습니다. 정기 보고는 누가 규정 준수 역할을 보유하고 있는지 파악하고, 조직이 보안 정책을 준수하고 있는지 확인하는 데 도움이 됩니다. 다음은 이러한 보고서를 효과적으로 예약하기 위한 몇 가지 단계입니다:

PowerShell cmdlet 사용: PowerShell cmdlet을 활용하여 보고서 생성 프로세스를 자동화하십시오. 지정된 간격으로 실행되는 스크립트를 만들 수 있습니다.
작업 스케줄러 설정: Windows 작업 스케줄러를 사용하여 PowerShell 스크립트를 자동으로 실행하십시오. 이렇게 하면 수동 작업 없이도 최신 보고서를 받을 수 있습니다.
보고서 형식 선택: 보고서를 .PDF와 같은 보안 형식으로 저장하십시오. 이렇게 하면 민감한 정보를 보호하고 권한이 있는 사용자와 쉽게 공유할 수 있습니다.

팁: 보고서에 대한 액세스 권한을 부여할 때는 항상 최소 권한 원칙을 적용하십시오. 이렇게 하면 무단 액세스 위험을 최소화할 수 있습니다.

보고서 데이터 분석

보고서를 생성했다면 데이터 분석이 매우 중요합니다. 규정 준수 역할 그룹의 멤버십을 이해하면 잠재적인 보안 위험을 식별하는 데 도움이 됩니다. 효과적인 분석을 위한 몇 가지 전략은 다음과 같습니다:

멤버십 정기 검토: 각 역할 그룹에 누가 속해 있는지 확인하십시오. 민감한 데이터에 승인된 사용자만 액세스할 수 있는지 확인하십시오. 주요 역할 그룹에는 Purview 관리자 및 데이터 원본 관리자가 포함됩니다.
추세 파악: 역할 그룹 멤버십의 패턴을 살펴보십시오. 이를 통해 비정상적인 활동이나 추가 조사가 필요한 변경 사항을 발견할 수 있습니다.
분석 결과 문서화: 분석 내용을 기록으로 남기십시오. 이 문서는 규정 준수 감사의 증거로 활용될 수 있으며, 시간에 따른 변경 사항을 추적하는 데 도움이 됩니다.

이러한 모범 사례를 따르면 보고 프로세스를 개선하고 조직이 Microsoft 365 규정 준수 표준을 계속 충족하도록 할 수 있습니다.

이 가이드에서는 PowerShell을 사용하여 Purview 역할 그룹 보고서를 생성하는 방법을 배웠습니다. Microsoft Purview에 연결하고 자격 증명을 인증한 다음, PowerShell 스크립트를 실행하여 역할 그룹 멤버십을 가져왔습니다.

정기 보고는 보안과 규정 준수를 유지하는 데 필수적입니다. 액세스를 모니터링하고 잠재적인 위험을 식별하는 데 도움이 됩니다.

이 프로세스를 업무 흐름에 통합하시기를 권장합니다. 그렇게 하면 조직의 보안 태세가 강화되고 업계 표준을 준수할 수 있습니다.

자주 묻는 질문

Microsoft Purview란 무엇인가요?

Microsoft Purview는 다양한 환경에 걸쳐 데이터를 관리하고 보호하는 데 도움을 주는 통합 데이터 거버넌스 솔루션입니다. 데이터 검색, 분류 및 규정 준수를 위한 도구를 제공합니다.

Purview 보고서에 PowerShell을 사용하는 이유는 무엇인가요?

PowerShell을 사용하면 보고서 생성 프로세스가 자동화되어 시간을 절약하고 수작업 오류를 줄일 수 있습니다. Purview에서 역할 그룹 멤버십을 효율적으로 가져오고 관리할 수 있습니다.

Purview 역할 그룹 보고서는 얼마나 자주 생성해야 하나요?

Purview 역할 그룹 보고서는 정기적으로, 가능하면 매월 또는 분기마다 생성하는 것이 좋습니다. 이렇게 하면 액세스를 모니터링하고 보안 정책을 규정 준수 상태로 유지하는 데 도움이 됩니다.

PowerShell 스크립트를 실행하는 중 오류가 발생하면 어떻게 하나요?

오류가 발생하면 권한을 확인하고, 필요한 모든 모듈이 설치되어 있는지 점검하며, Microsoft Purview 연결 상태를 확인하세요. 구체적인 해결 방법은 오류 메시지를 검토하면 확인할 수 있습니다.

보고서 형식을 사용자 지정할 수 있나요?

네, 보고서 형식을 사용자 지정할 수 있습니다. 필요에 따라 PowerShell 스크립트를 수정하여 CSV 또는 PDF 파일 생성 등 출력 형식을 변경하세요.

Purview 포털 및 Purview 규정 준수

이 자주 묻는 질문은 PowerShell로 Purview 역할 그룹 보고서를 생성하는 방법에 초점을 맞추고, Microsoft Purview 및 Microsoft 365의 관련 권한, 역할 관리, 감사를 설명합니다.

PowerShell 모듈, Microsoft Purview 권한, Purview RBAC 역할

이 안내에서는 PowerShell 모듈과 Microsoft Graph PowerShell SDK를 사용하여 역할 그룹 구성원을 나열하고, 기본 제공 역할 정의를 검토하고, 규정 준수 및 eDiscovery 시나리오를 위한 보고서를 만드는 방법을 다룹니다.

PowerShell로 만드는 Purview 역할 그룹 보고서란 무엇이며, 왜 만들어야 하나요?

PowerShell로 만드는 Purview 역할 그룹 보고서는 Microsoft Purview 솔루션과 Microsoft 365 서비스 전반의 역할 그룹, 역할 할당(Purview RBAC 역할 및 기본 제공 역할 매핑), 역할 그룹 구성원을 정리한 목록(CSV 또는 JSON)입니다. 역할 권한을 감사하고, 전역 관리자 역할이나 관리자 역할 같은 권한 있는 역할에 누가 액세스할 수 있는지 확인하며, 규정 준수 검토와 eDiscovery 사례를 지원하고, 변경 관리 및 내부자 위험 관리 권한 검토에 활용하기 위해 만듭니다.

Purview 역할 그룹 보고서를 생성하려면 어떤 PowerShell 모듈을 사용하나요?

환경에 따라 여러 모듈을 조합하여 사용합니다. Microsoft Graph PowerShell SDK로 Microsoft Purview 포털의 역할 할당과 역할 그룹 구성원을 조회하고, 일부 Microsoft 365 및 eDiscovery 전용 역할 그룹에는 Exchange Online Management 모듈 또는 Security & Compliance 모듈을 사용합니다. Microsoft는 Purview 데이터 및 Purview 규정 준수 포털 작업에 대한 예제를 Microsoft Learn에 문서화하기도 합니다.

PowerShell로 Purview 역할 그룹 보고서를 실행하려면 어떤 권한이 필요한가요?

일반적으로 역할 관리 기능이 있는 전역 관리자 역할이나 위임된 관리자 역할 같은 상위 권한이 필요합니다. 또는 Purview 포털의 관리 역할(권한 있는 역할 또는 관리자 역할)과 같은 특정 Microsoft Purview 권한이 필요할 수도 있습니다. 일부 쿼리에서는 Organization Management 역할 그룹 또는 eDiscovery Manager 역할 그룹에 할당되어 있어야 할 수 있습니다. Microsoft Graph PowerShell SDK로 역할 할당과 감사 로그 항목을 읽을 때는 필요한 Graph 권한에 대한 동의가 완료되었는지 확인하세요.

Microsoft Graph PowerShell SDK로 역할 그룹 구성원과 역할을 나열하려면 어떻게 하나요?

roleManagement.read.* 및 Directory.Read.All을 포함하는 위임 또는 앱 권한으로 인증한 다음, roleDefinitions와 roleAssignments를 조회하여 Purview RBAC 역할을 역할 그룹에 매핑하고 역할 그룹 구성원을 열거합니다. 결과를 CSV로 내보내면 보고서가 완성됩니다. eDiscovery Manager 역할 그룹과 같은 Exchange Online 전용 그룹의 경우, 역할 그룹 구성원과 콘텐츠 검색 권한을 나열하려면 Exchange Online Management 모듈이 필요할 수 있습니다.

같은 보고서에 eDiscovery 및 정보 보호 역할을 포함할 수 있나요?

네, 가능합니다. Microsoft Purview 포털(Microsoft Purview 솔루션 및 Microsoft Purview Data 역할), Microsoft 365 서비스(콘텐츠 검색, eDiscovery 사례, eDiscovery Manager 역할 및 eDiscovery Manager 역할 그룹), Microsoft Information Protection 할당 정보를 결합하세요. 여러 PowerShell 모듈이나 Graph 쿼리를 사용해 역할 권한을 집계한 다음, 정규화하여 하나의 보고서로 내보내면 됩니다.

역할 그룹의 변경 사항을 감사하고 시간에 따라 역할 권한을 추적하려면 어떻게 해야 하나요?

Microsoft Graph PowerShell SDK 또는 Purview 규정 준수 포털의 감사 API로 접근할 수 있는 감사 로그와 Azure AD 로그인 및 감사 이벤트(Microsoft Entra / Microsoft Entra ID)를 사용하세요. 역할 할당과 역할 그룹 구성원 목록을 주기적으로 내보내도록 예약하여 변경 사항을 탐지합니다. 과거 스냅샷을 저장해 두면 권한 변화 탐지가 가능하고, 규정 준수 증적 수집에도 도움이 됩니다.

Purview 역할 그룹 보고서에서 주의해야 할 기본 제공 역할의 일반적인 제한 사항은 무엇인가요?

기본 제공 역할 정의는 범위가 넓을 수 있으며(예: 전역 관리자, 규정 준수 관리자), Microsoft Purview 규정 준수, 제거(purge) 작업 또는 권한 있는 데이터에 대한 액세스 권한을 부여할 수 있습니다. 보고서에서는 기본 제공 역할 간의 중복, 기본 역할 그룹, 그리고 Microsoft Purview Data, Microsoft Defender XDR 또는 Microsoft 365 Copilot 데이터에 대한 상승된 액세스 권한을 사실상 부여하는 할당을 강조해야 합니다. 일부 기본 제공 역할은 변경할 수 없지만 개수를 파악하고 모니터링할 수는 있다는 점에 유의하세요.

위임된 관리를 위해 역할 그룹을 어떻게 처리하고 권한 있는 역할 노출을 어떻게 줄일 수 있나요?

권한 있는 역할에 할당된 역할 그룹 구성원을 식별하고, 가능하면 더 좁은 범위의 사용자 지정 역할을 만들고, 불필요한 역할 그룹 멤버십을 제거하며, 긴급 액세스를 위해 비상 접근(break-glass) 제어를 사용하는 최소 권한 원칙을 적용하는 것을 고려하세요. 권한 있는 역할 위험을 최소화하려면 보고서에서 조직 관리 역할 그룹의 사용자, 관리자 역할 보유자, 그리고 역할이 할당된 모든 서비스 주체를 표시해야 합니다.

이러한 보고서를 만들고 자동화하는 예시와 모범 사례는 어디에서 찾을 수 있나요?

Microsoft Graph PowerShell SDK, Exchange Online Management 모듈, 규정 준수 포털 API를 사용한 PowerShell 예시는 Microsoft Learn 및 관련 문서를 참고하세요. 모범 사례에는 예약된 내보내기 자동화, 감사 로그 항목 캡처, 역할 권한을 권한 집합으로 문서화, 그리고 역할 관리, 역할 권한 검토, 규정 준수 감사를 위한 거버넌스 워크플로와 결과 통합이 포함됩니다.