从 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 中导出用户内容

  1. 在 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
    
  2. 系统将提示进行身份验证。 以自己 (全局管理员) 登录,而不是要导出的用户。

  3. 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 本系列中上一个任务的任务 IDnull 对于系列中的第一个任务,因为它没有前置任务。 系列中的每个后续任务都有一个与其前置任务对应的值。
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 实体类型(用户或组)。

删除 Microsoft Planner 中的用户数据