从 Microsoft 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 使用要导出其内容的用户的 Azure Active Directory 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 用户的 Azure Active Directory 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 实体（组或用户）的 Azure Active Directory ID。
Plan.Owner.DisplayName 所有者（组或用户）的显示名称。
Plan.Owner.UserPrincipalName 如果所有者是用户，则为用户主体名称 (UPN)。
Plan.Owner.PrincipalType 实体类型（组或用户）。
Plan.Container 计划的容器。
Plan.Container.ContainerType 容器的类型（组、名单）。
Plan.Container.ExternalId 组的 Azure Active Directory 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.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 用户的 Azure Active Directory ID。
DisplayName 用户的显示名称。
UserPrincipalName 用户的用户主体名称 (UPN)。
PrincipalType 实体类型（用户或组）。

删除 Microsoft Planner 中的用户数据