从 Microsoft Planner 中导出用户数据
重要
本文适用于：
- Teams 中Planner应用中的基本计划
- 其他Planner终结点中的所有计划 (包括Planner Web、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 文件中都会看到的属性。
用户文件
用户文件名将以“User”和用户的 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”。 |
| 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 Web 客户端的自定义数据。 |
| 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 | 任务的标题。 |
计划文件
每个计划文件名均以“Plan”和计划的 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 | 此重复序列开始的日期和时间。 对于 series (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 表示任务每隔两天 (或每隔一天) 重复一次。 对于每月模式，间隔 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 | 上次更新存储桶的日期。 |
Plans.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 | 实体类型（用户或组）。 |