Microsoft Planner에서 사용자 데이터 내보내기
중요
이 글의 적용 대상:
- Teams에서 Planner 앱의 기본 계획
- 다른 Planner 엔드포인트(Planner 웹, Planner 모바일 및 Planner 커넥터 포함)의 모든 계획
Teams의 Planner 앱에서 할 일 목록 또는 프리미엄 플랜에는 적용되지 않습니다. Teams의 Planner 앱에 대해 자세히 알아보기
이 문서에서는 전역 관리자가 Microsoft Planner에서 특정 사용자에 대한 데이터를 내보내는 방법을 설명합니다. 내보낸 데이터에는 Planner 포함된 사용자에 대한 데이터와 사용자가 속한 계획에 포함된 데이터가 포함됩니다. 내보내기 프로세스는 Windows PowerShell을 통해 수행 됩니다.
참고
전역 관리자는 Microsoft 서비스 보안 포털에서 데이터 로그 내보내기 도구를 통해 Microsoft Planner 사용자 원격 분석 데이터를 내보낼 수 있습니다.
Windows PowerShell에서 Planner 변경의 필수 구성 요소
Windows PowerShell에서 Planner를 변경하려면 Windows PowerShell에서 Planner 변경의 필수 구성 요소의 단계를 따르세요.
Planner에서 사용자 콘텐츠 내보내기
Windows PowerShell에서 Export-PlannerUserContent cmdlet를 사용하여 Planner에서 사용자 콘텐츠를 내보냅니다.
Export-PlannerUserContent -UserAadIdOrPrincipalName <user's AADId or UPN> -ExportDirectory <output location>매개 변수 설명 UserAadIdOrPrincipalName 콘텐츠를 내보내려는 사용자의 Microsoft Entra ID 또는 UPN을 사용합니다. ExportDirectory 출력 파일을 저장할 위치입니다. 폴더가 이미 있어야 합니다. HostName 작업 이외의 호스트 이름을 통해 Planner 액세스하는 경우에만 이 매개 변수를 사용해야 합니다.사무실.com. 예를 들어 작업을 통해 Planner 액세스하는 경우입니다.office365.-HostName 작업을 포함합니다.명령의 office365.us. 예를 들어 그 다음에는 Adam Barr의 사용자 정보를 해당 UPN을 사용하여 Planner에서 내보내고 C:\PlannerExportAdamBarr 위치에 내보낸 파일을 다운로드 하는 것입니다.
Export-PlannerUserContent -UserAadIdOrPrincipalName adambarr@contoso.onmicrosoft.com -ExportDirectory C:\PlannerExportAdamBarr인증하라는 메시지가 표시됩니다. 내보낼 사용자가 아닌 자신(전역 관리자)으로 로그인합니다.
PowerShell cmdlet를 성공적으로 실행한 후, 내보낼 위치로 이동하여 사용자의 내보낸 데이터 파일을 확인합니다.
내보낸 파일 및 읽는 방법
PowerShell cmdlet을 실행하여 Planner 사용자의 데이터를 내보낸 후 다운로드 위치 폴더에 두 가지 유형의 파일을 받게 됩니다.
- 사용자에 대한 정보가 포함된 json 형식의 단일 사용자 파일입니다.
- 다음의 사용자가 수행하는 각 계획에 대한 하나의 json 파일:
- 할당된 작업을 가진 사용자.
- 생성된 작업을 가진 사용자.
내보낸 파일을 읽는 방법
이 섹션의 정보를 사용하여 받은 사용자 및 계획 json 파일 모두에서 볼 수 있는 속성을 이해할 수 있습니다.
사용자 파일
"사용자" 접두사가 붙는 사용자 파일 이름 및 사용자의 Microsoft Planner ID입니다. 다음 속성을 갖습니다:
| 속성 | 설명 |
|---|---|
| User.Id | 사용자의 Microsoft Planner ID입니다. |
| User.ExternalId | 사용자의 Microsoft Entra ID. |
| user.DisplayName | 사용자 표시 이름입니다. |
| User.InternalDisplayName | 사용자의 Microsoft Planner 표시 이름입니다. |
| user.userprincipalname | 사용자의 사용자 계정 이름(UPN)입니다. |
| User.PrincipalType | 값은 항상 "사용자"입니다. |
| User.UserDetailsId | 사용자에 대한 세부 정보 개체의 고유 식별자입니다. |
| User.ICalendarPublishEnabled | True이면 계획에 ICalendar 공유를 사용할 수 있습니다. 자세한 내용은 Outlook에서 Planner 일정 보기를 참조하세요. |
| User.OptedInNotifications | 사용자의 옵트인 알림. |
| User.OptedOutNotifications | 사용자의 옵트아웃 알림. |
| User.FavoritePlans | 사용자가 선호하는 계획에 대한 북마크입니다. |
| User.FavoritePlans.Id | 계획에 대한 Microsoft Planner ID입니다. |
| User.FavoritePlans.BookmarkName | 북마크에 할당된 이름입니다. |
| User.FavoritePlans.OrderHint | 소트 순서에 사용됩니다. Microsoft Planner에서 순서 힌트 사용을 참조하세요. |
| User.RecentPlans | 최근 사용자가 열어 본 계획입니다. |
| User.RecentPlans.Id | 계획에 대한 Microsoft Planner ID입니다. |
| User.RecentPlans.BookmarkName | 북마크에 할당된 이름입니다. |
| User.RecentPlans.LastAccess | 계획이 마지막으로 열린 경우. |
| User.UserData | Planner 웹 클라이언트에서 사용자 지정 데이터 |
| User.UserData.Key | 사용자 지정 데이터 키. |
| User.UserData.Value | 사용자 지정 데이터 값. |
| User.AssignedTaskOrdering | 사용자에게 할당된 작업의 소트 순서입니다. |
| User.AssignedTaskOrdering.PlanId | 작업을 포함하는 계획에 대한 Microsoft Planner ID입니다. |
| User.AssignedTaskOrdering.Id | 작업에 대한 Microsoft Planner ID입니다. |
| User.AssignedTaskOrdering.Order | 소트 순서에 사용됩니다. Microsoft Planner에서 순서 힌트 사용을 참조하세요. |
| User.AssignedTaskOrdering.Title | 작업의 제목입니다. |
계획 파일
"계획" 접두사가 붙는 각 계획 파일 이름 및 계획에 대한 Microsoft Planner ID입니다. 각 파일은 다음 속성을 갖습니다:
| 속성 | 설명 |
|---|---|
| Plan.Id | 계획에 대한 Microsoft Planner ID입니다. |
| Plan.Title | 계획의 제목입니다. 참고: 제목 RosterPlaceholderPlan_{89F9907E-D21D-4C90-A4B8-7A76CF3E6F70} 이 있는 계획은 현재 파일이 생성되었지만 아직 그 안에 계획이 만들어지지 않은 명단을 나타낸다는 것을 나타냅니다. |
| Plan.Owner | 계획의 소유자 (그룹 또는 사용자 엔터티)입니다. |
| Plan.Owner.Id | 엔터티 (그룹 또는 사용자)의 Microsoft Planner ID입니다. |
| Plan.Owner.ExternalId | 엔터티(그룹 또는 사용자)의 Microsoft Entra ID. |
| Plan.Owner.DisplayName | 소유자 (그룹 또는 사용자)의 표시 이름입니다. |
| Plan.Owner.UserPrincipalName | 소유자가 사용자인 경우, 사용자 계정 이름(UPN)입니다. |
| Plan.Owner.PrincipalType | 엔터티 형식 (그룹 또는 사용자). |
| Plan.Container | 계획 컨테이너 |
| Plan.Container.ContainerType | 컨테이너 형식(그룹, 명단) |
| Plan.Container.ExternalId | 그룹의 Microsoft Entra ID. |
| Plan.Container.Description | 그룹 이름 표시 |
| Plan.CreatedDate | 계획을 만든 날짜 및 시간입니다. |
| Plan.CreatedBy | 계획을 만든 사용자입니다. 자세한 내용은 사용자 속성을 참조하세요. |
| Plan.ModifiedDate | 계획이 마지막으로 업데이트된 날짜 및 시간입니다. |
| Plan.ModifiedBy | 계획을 마지막으로 업데이트한 사용자의 이름입니다. 자세한 내용은 사용자 속성을 참조하세요. |
| Plan.PlanDetailsId | 계획 세부 정보 개체의 고유 식별자입니다. |
| Plan.ICalendarPublishEnabled | True이면 계획에 ICalendar 공유를 사용할 수 있습니다. 자세한 내용은 일정에서 작업을 참조하세요 . |
| Plan.CreateTaskCommentWhen | 계획의 작업에 대한 메모를 생성하는 이벤트입니다. |
| Plan.ReferencesToPlan | 계획에 연결되는 외부 시스템입니다. 예를 들어, Project Online 데스크톱 클라이언트에 Microsoft Planner 계획을 포함합니다. |
| Plan.ReferencesToPlan.ExternalId | 계획에 대한 외부 시스템의 ID입니다. |
| Plan.ReferencesToPlan.AssociationType | 계획에 대한 링크 유형으로 외부 앱에서 지정합니다. |
| Plan.ReferencesToPlan.CreatedDate | 레퍼런스 개체를 만든 날짜와 시간입니다. |
| Plan.ReferencesToPlan.CustomLinkText | URL을 표시할 때 사용할 수 있는 텍스트입니다. |
| Plan.ReferencesToPlan.DisplayAs | 사용자 환경에서 URL과 같은 참조 데이터를 표시하는 방법을 지정합니다. |
| Plan.ReferencesToPlan.IsCreationContext | 계획을 만들 때 참조가 설정된 경우 true(으)로 설정합니다. |
| Plan.ReferencesToPlan.OwnerAppId | 레퍼런스를 만든 앱의 ID입니다. |
| Plan.ReferencesToPlan.DisplayNameSegments | 계획을 참조하는 개체를 설명하는 위치의 이동 경로입니다. |
| Plan.ReferencesToPlan.Url | 계획을 참조하는 앱에 대한 직접 링크입니다. |
| Plan.CategoryDescriptions | 계획에 대한 전체 범주의 집합입니다. |
| Plan.CategoryDescriptions.Index | 범주 설명의 인덱스입니다. |
| Plan.CategoryDescriptions.Description | 해당 범주 설명 인덱스 값에 대한 레이블 텍스트입니다. |
| Plan.PlanFollowers | Plan.Container.ContainerType이 그룹인 경우 이 필드는 계획을 따르는 사용자입니다. Plan.Container.ContainerType이 명단인 경우 이 필드는 명단의 구성원인 사용자입니다. |
| Plan.TimelineId | 기능이 더 이상 사용되지 않습니다. |
| Plan.TimelineDisplaySettings | 기능이 더 이상 사용되지 않습니다. |
| Plan.TimelineLockedWidth | 기능이 더 이상 사용되지 않습니다. |
| Plan.Tasks | 계획에 대한 작업 개체입니다. |
| Plan.Tasks.Id | 작업의 고유 식별자입니다. |
| Plan.Tasks.Title | 작업의 이름입니다. |
| Plan.Tasks.BucketId | 작업이 있는 버킷에 대한 Microsoft Planner ID입니다. |
| Plan.Tasks.BucketName | 버킷의 이름입니다. |
| Plan.Tasks.PercentComplete | 작업의 완료 상태는 0에서 100까지입니다. |
| Plan.Tasks.StartDate | 작업이 시작되도록 예정된 날짜입니다. |
| Plan.Tasks.DueDate | 작업이 완료되도록 예정된 날짜입니다. |
| Plan.Tasks.ConversationThreadId | Microsoft Exchange에서 대화 고유 식별자입니다. |
| Plan.Tasks.PreviewType | 작업 카드에 표시되는 미리 보기입니다. |
| Plan.Tasks.OrderHint | 소트 순서에 사용됩니다. Microsoft Planner에서 순서 힌트 사용을 참조하세요. |
| Plan.Tasks.CreatedBy | 작업을 만든 사용자입니다. 자세한 내용은 사용자 속성을 참조하세요. |
| Plan.Tasks.CreatedDate | 작업이 만들어진 날짜입니다. |
| Plan.Tasks.CompletedBy | 작업을 완료한 사용자입니다. 자세한 내용은 사용자 속성을 참조하세요. |
| Plan.Tasks.CompletedDate | 작업이 완료된 날짜입니다. |
| Plan.Tasks.ModifiedBy | 작업을 마지막으로 업데이트한 사용자입니다. 자세한 내용은 사용자 속성을 참조하세요. |
| Plan.Tasks.ModifiedDate | 작업이 마지막으로 업데이트된 날짜입니다. |
| Plan.Tasks.AppliedCategories | 계획에 대한 CategoryDescriptions 인덱스에서 선택된 레이블입니다. |
| Plan.Tasks.Recurrence | 작업에 대한 활성 또는 비활성 되풀이를 정의합니다. null 되풀이가 태스크에 대해 정의되지 않은 경우 |
| Plan.Tasks.Recurrence.SeriesId | 이 작업이 속한 되풀이 시리즈입니다. 계열의 고유 식별자 역할을 하는 GUID 기반 값입니다. |
| Plan.Tasks.Recurrence.OccurrenceIndex | 되풀이 계열 내에서 이 작업의 1 기반 인덱스입니다. 계열의 첫 번째 작업에는 값 1, 계열의 다음 태스크에는 값 2등이 있습니다. |
| Plan.Tasks.Recurrence.PreviousInSeriesTaskId | 이 시리즈의 이전 작업의 작업 ID 입니다. null 는 선행 작업이 없으므로 시리즈의 첫 번째 작업입니다. 계열의 각 후속 작업에는 선행 작업에 해당하는 값이 있습니다. |
| Plan.Tasks.Recurrence.NextInSeriesTaskId | 이 시리즈의 다음 작업의 작업 ID 입니다. 이 값은 계열의 다음 작업이 생성되는 시점에 할당되며 이 시간 이전입니다 null . |
| Plan.Tasks.Recurrence.RecurrenceStartDate | 이 되풀이 계열이 시작된 날짜 및 시간입니다. 계열의 첫 번째 작업(OccurrenceIndex = 1)의 경우 이 값은 Schedule.Range.StartDate에 해당합니다. 계열의 후속 작업(OccurrenceIndex>= 2)의 경우 이 값은 이전 작업에서 복사되며 변경되지 않습니다. 되풀이 계열의 시작 날짜는 유지됩니다. |
| Plan.Tasks.Recurrence.Schedule | 되풀이 일정입니다. null 는 되풀이가 취소되었음을 나타냅니다. NextInSeriesTaskId가 할당되면 이 일정 값은 이 작업이 완료될 때 일정이 어떻게 생겼는지에 대한 스냅샷 유지됩니다. |
| Plan.Tasks.Recurrence.Schedule.Pattern | 되풀이 패턴입니다. Schedule.Range와 함께 패턴은 Schedule.NextOccurrenceDate를 계산하는 데 사용됩니다. |
| Plan.Tasks.Recurrence.Schedule.Pattern.IsDailyCadence | True 일별 주기( 이 경우 DaysOrDates 가 비어 있음). False 그렇지 않으면(즉, 매주, 매월 또는 연간 주기의 경우) |
| Plan.Tasks.Recurrence.Schedule.Pattern.Interval | 주기 종류에 적용되는 간격입니다. 1보다 큰 값은 마침표가 건너뛰는 것을 의미합니다. 예: 일별 패턴의 경우 간격 2는 태스크가 2일마다(또는 격일로) 되풀이됨을 의미합니다. 월별 패턴의 경우 간격 3은 3개월마다 작업이 되풀이됨을 의미합니다(분기별라고도 함). |
| Plan.Tasks.Recurrence.Schedule.Pattern.DaysOrDates | 이 컬렉션의 각 항목은 정확히 하루 또는 날짜의 정의를 나타냅니다. 예: "FixedYearly,August,15" 는 해당 연도의 8월 15일에 을 의미합니다. "FloatingMonthly,Second,Monday" 은 월의 두 번째 월요일에 을 의미합니다. "Weekly,Wednesday","Weekly,Friday" 는 매주 수요일과 금요일에 표시됩니다. |
| Plan.Tasks.Recurrence.Schedule.Pattern.FirstDayOfWeek | 요일(일반적으로 일요일)입니다. 이는 주별 패턴에서만 사용되며 null 주별이 아닌 패턴에 사용됩니다. |
| Plan.Tasks.Recurrence.Schedule.Range | 되풀이가 시작되고 끝나는 시기를 지정합니다. |
| Plan.Tasks.Recurrence.Schedule.Range.StartDate | Recurrence.Schedule을 시작해야 하는 날짜입니다. 이 값은 Recurrence.Schedule.Pattern을 변경할 때 사용자가 업데이트할 수 있습니다. |
| Plan.Tasks.Recurrence.Schedule.Range.Kind | 현재 지원되는 유일한 값은 이며 NoEnd계열이 자동으로 종료되지 않음을 나타냅니다. |
| Plan.Tasks.Recurrence.Schedule.NextOccurrenceDate | 이 Recurrence.Schedule의 다음 날짜입니다. 되풀이 계열을 계속하기 위해 새 작업을 인스턴스화하면 이 날짜가 새 작업의 DueDate 에 사용됩니다. |
| Plan.Tasks.TaskDetailsId | 작업에 대한 세부 정보 개체의 고유 식별자입니다. |
| Plan.Tasks.Description | 작업에 대한 설명입니다. |
| Plan.Tasks.AssignedToTaskBoardFormatId | 작업 게시판 형식인 개체의 고유 식별자입니다. |
| Plan.Tasks.AssignedToTaskBoardFormatUnassignedOrderHint | 소트 순서에 사용됩니다. Microsoft Planner에서 순서 힌트 사용을 참조하세요. |
| Plan.Tasks.AssignedToTaskBoardFormatOrderHintsByAssignee | 각 할당자에 대한 순서 힌트입니다. |
| Plan.Tasks.AssignedToTaskBoardFormatOrderHintsByAssignee.AssignedTo: | 작업이 할당된 사용자입니다. 자세한 내용은 사용자 속성을 참조하세요. |
| Plan.Tasks.AssignedToTaskBoardFormatOrderHintsByAssignee.Order | 할당 대상 보기에서 할당자가 지정한 작업의 순서입니다. |
| Plan.Tasks.BucketTaskBoardFormatId | 버킷 작업 게시판 형식인 개체의 고유 식별자입니다. |
| Plan.Tasks.BucketTaskBoardFormatOrderHint | 소트 순서에 사용됩니다. Microsoft Planner에서 순서 힌트 사용을 참조하세요. |
| Plan.Tasks.ProgressTaskBoardFormatId | 버킷 서식 대신 진행 중에 그룹화된 개체의 고유 식별자입니다. |
| Plan.Tasks.ProgressTaskBoardFormatOrderHint | 소트 순서에 사용됩니다. Microsoft Planner에서 순서 힌트 사용을 참조하세요. |
| Plan.Tasks.TimelineFormatId | 기능이 더 이상 사용되지 않습니다. |
| Plan.Tasks.TimelineFormatShowOnTimeline | 기능이 더 이상 사용되지 않습니다. |
| Plan.Tasks.TimelineFormatAnchorPosition | 기능이 더 이상 사용되지 않습니다. |
| Plan.Tasks.TimelineFormatCalloutHeight | 기능이 더 이상 사용되지 않습니다. |
| Plan.Tasks.TimelineFormatColor | 기능이 더 이상 사용되지 않습니다. |
| Plan.Tasks.TimelineFormatDrawingStyle | 기능이 더 이상 사용되지 않습니다. |
| Plan.Tasks.TimelineFormatLabelOffsetX | 기능이 더 이상 사용되지 않습니다. |
| Plan.Tasks.TimelineFormatLabelOffsetY | 기능이 더 이상 사용되지 않습니다. |
| Plan.Tasks.TimelineFormatSwimlane | 기능이 더 이상 사용되지 않습니다. |
| Plan.Tasks.References | 외부 링크입니다. |
| Plan.Tasks.References.Url | 링크의 URL입니다. |
| Plan.Tasks.References.Alias | 링크에 대한 설명 텍스트입니다. |
| Plan.Tasks.References.Type | 연결할 파일의 유형입니다. |
| Plan.Tasks.References.ModifiedBy | 링크를 마지막으로 업데이트한 사용자입니다. 자세한 내용은 사용자 속성을 참조하세요. |
| Plan.Tasks.References.ModifiedDate | 링크가 마지막으로 업데이트된 날짜입니다. |
| Plan.Tasks.References.PreviewPriority | UI에서 작업에 대한 미리 보기로 표시할 레퍼런스의 우선 순위를 나타냅니다. Microsoft Planner는 가장 높은 우선 순위 항목만 보여 줍니다. |
| Plan.Tasks.Assignments | 작업을 할당합니다. |
| Plan.Tasks.Assignments.AssignedTo | 작업이 할당된 사용자입니다. 자세한 내용은 사용자 속성을 참조하세요. |
| Plan.Tasks.Assignments.AssignedBy | 작업을 할당한 사용자입니다. 자세한 내용은 사용자 속성을 참조하세요. |
| Plan.Tasks.Assignments.Order | 작업이 여러 엔터티에 할당되는 경우 할당의 순서입니다. |
| Plan.Tasks.Checklist | 작업에 대한 검사 목록입니다. |
| Plan.Tasks.Checklist.Id | 검사 목록 항목의 고유 식별자입니다. |
| Plan.Tasks.Checklist.Title | 검사 목록 항목의 이름입니다. |
| Plan.Tasks.Checklist.OrderHint | 소트 순서에 사용됩니다. Microsoft Planner에서 순서 힌트 사용을 참조하세요. |
| Plan.Tasks.Checklist.IsChecked | True인 경우 검사 목록 항목이 완료된 것입니다. |
| Plan.Tasks.Checklist.ModifiedBy | 검사 목록을 마지막으로 업데이트한 사용자입니다. 자세한 내용은 사용자 속성을 참조하세요. |
| Plan.Tasks.Checklist.ModifiedDate | 검사 목록이 마지막으로 업데이트된 날짜입니다. |
| Plan.Tasks.UserContentLastModifiedBy | 작업 또는 작업의 세부 정보를 마지막으로 업데이트한 사용자입니다. 자세한 내용은 사용자 속성을 참조하세요. |
| Plan.Tasks.UserContentLastModifiedDate | 작업 또는 작업의 세부 정보가 마지막으로 업데이트된 날짜입니다. |
| Plan.Buckets | 계획에 대한 버킷 개체입니다. |
| Plan.Buckets.Id | 버킷에 대한 고유 식별자입니다. |
| Plan.Buckets.Title | 버킷의 이름입니다. |
| Plan.Buckets.OrderHint | 소트 순서에 사용됩니다. Microsoft Planner에서 순서 힌트 사용을 참조하세요. |
| Plan.Buckets.Createdby | 버킷을 만든 사용자입니다. 자세한 내용은 사용자 속성을 참조하세요. |
| Plan.Buckets.CreatedDate | 버킷을 만든 날짜입니다. |
| Plan.Buckets.ModifiedBy | 버킷을 마지막으로 업데이트한 사용자입니다. 자세한 내용은 사용자 속성을 참조하세요. |
| Plan.Buckets.ModifiedDate | 버킷이 마지막으로 업데이트된 날짜입니다. |
계획.json 파일에 대한 사용자 속성입니다.
Plans.json 데이터에는 Microsoft Planner 사용자를 나타내고 비슷한 속성을 갖는 많은 개체가 있습니다. 이러한 개체는 다음을 포함합니다:
- Plan.CreatedBy
- Plan.ModifiedBy
- Plan.PlanFollowers
- Plan.Tasks.CreatedBy
- Plan.Tasks.CompletedBy
- Plan.Tasks.ModifiedBy
- Plan.Tasks.AssignedToTaskBoardFormatOrderHintsByAssignee.AssignedTo
- Plan.Tasks.References.ModifiedBy
- Plan.Tasks.Assignments.AssignedTo
- Plan.Tasks.Assignments.AssignedBy
- Plan.Tasks.Checklists.ModifiedBy
- Plan.Bucket.Createdby
- Plan.Bucket.Modifiedby
위의 각 매개변수는 다음 속성을 갖습니다:
| 속성 | 설명 |
|---|---|
| ID | 사용자의 Microsoft Planner ID입니다. |
| externalId | 사용자의 Microsoft Entra ID. |
| DisplayName | 사용자 표시 이름입니다. |
| UserPrincipalName | 사용자의 사용자 계정 이름(UPN)입니다. |
| PrincipalType | 엔터티 형식 (사용자 또는 그룹)입니다. |