将用户数据导出从 Microsoft 规划器

注意: 我们希望能够尽快以你的语言为你提供最新的帮助内容。本页面是自动翻译的,可能包含语法错误或不准确之处。我们的目的是使此内容能对你有所帮助。可以在本页面底部告诉我们此信息是否对你有帮助吗?请在此处查看本文的英文版本以便参考。

重要: 

  • 本文不支持将计划数据导出到 Excel, 这种情况下目前不支持。 如果你想要向 microsoft 提供有关此功能的需求的反馈, 请参阅此Microsoft Planner UserVoice 页面以对该功能进行投票并提供你的评论。

本文介绍 Office 365 全局管理员如何可以从 Microsoft Planner 导出特定用户的数据。导出的数据将包含有关 Planner 中包含的用户的数据, 以及用户所属计划中包含的数据。导出过程通过 Windows PowerShell 完成。

注意: Office 365 全局管理员可以通过microsoft 服务信任门户上的数据记录导出工具导出 microsoft Planner 用户遥测数据。

要求

首先需要执行以下操作:

  • 你必须是 Office 365 全局管理员才能运行用于导出 Planner 用户数据的 PowerShell 脚本。

  • 你需要下载并解压缩Planner 用户数据导出文件。这三个文件是 PowerShell 模块和导出用户数据所需的 powershell 脚本文件。

    注意: 下载此程序包即表示你同意随附的许可证和条款。

取消阻止文件

你将需要在 Planner 用户数据导出脚本包中下载的三个文件 "取消阻止", 以便在 PowerShell 中对其进行用户操作。这是因为默认情况下, 不允许执行从 Internet 下载的脚本。您需要取消阻止的文件是:

  • plannertenantadmin. psm1

  • identitymodel 的链接。

  • identitymodel 中的 windowsforms。

执行下列操作以取消阻止这些文件:

  1. 在文件资源管理器中, 转到解压缩文件的位置。

  2. 右键单击上面提到的解压缩文件之一, 然后单击 "属性"。

  3. 在 "常规" 选项卡上, 选择 "取消阻止"。

    取消阻止的文件
  4. 单击"确定"。

  5. 对于其余两个文件, 请重复这些步骤。

从 Planner 中导出用户内容

取消阻止文件后, 请执行下列操作以从 Planner 导出用户数据:

  1. 启动 Windows PowerShell。在 PowerShell 中, 键入以下各项, 以便仅为此会话启用运行从 internet 下载的脚本。它可能会提示您键入 "Y" 进行确认。

    PS> Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope Process
  2. 键入以下各项以运行PlannerTenantAdmin PowerShell 脚本。这将导入包含所需 cmdlet 的模块以运行导出。

    PS> Import-module "<location of the .psm1 file>"

    例如, 如果文件存储在 C:\AdminScript 中, 则键入:

    PS> Import-module "C:\AdminScript\PlannerTenantAdmin.psm1"
  3. 脚本完成后, 使用PlannerUserContent cmdlet 导出来自 Planner 的用户的内容。

    PS> Export-PlannerUserContent -UserAadIdOrPrincipalName <user's AADId or UPN> -ExportDirectory <output location>

    参数

    说明

    -UserAadIdOrPrincipalName

    使用要导出其内容的用户的 Azure Active Directory ID 或 UPN。

    -ExportDirectory

    用于存储输出文件的位置。该文件夹应该已经存在。

    -HostName

    如果你通过使用除task.office.com以外的主机名访问 Planner, 你只需使用此参数。例如, 如果你通过tasks.office365.us访问 Planner, 请在命令中包含-HostName tasks.office365.us

    例如, 以下内容将从 Planner 中使用他的 UPN 导出 Adam Barr 的用户信息, 并将导出文件下载到位置C:\PlannerExportAdamBarr

    PS> Export-PlannerUserContent -UserAadIdOrPrincipalName adambarr@contoso.onmicrosoft.com -ExportDirectory C:\PlannerExportAdamBarr 
  4. 系统将提示你进行身份验证。以自己的身份登录 (Office 365 全局管理员), 而不是要导出的用户。

  5. PowerShell cmdlet 成功运行后, 转到你的导出位置以查看你的用户导出的数据文件。

导出的内容和阅读方法

在运行 PowerShell cmdlet 以从 Planner 导出用户的数据后, 你将在 "下载位置" 文件夹中收到两种类型的文件:

  • 具有有关用户信息的 json 格式的单个用户文件。

  • 一个用于用户的每个计划的 json 文件:

    • 具有分配给他或她的任务。

    • 具有由他/她创建的任务。

如何读取导出的文件

你可以使用本部分中的信息帮助你了解将在收到的用户和计划 json 文件中看到的属性。

用户文件

用户文件名将以 "user" 为前缀, 并带有用户的 Microsoft Planner ID。它将具有以下属性:

属性

说明

User.Id

Microsoft Planner 用户 ID。

ExternalId

用户的 Azure Active Directory ID。

用户名称 (DisplayName)

用户的显示名称。

InternalDisplayName

Microsoft Planner 显示用户的姓名。

用户 UserPrincipalName

用户的用户主体名称 (UPN)。

PrincipalType

值始终为 "用户"。

UserDetailsId

用户的详细信息对象的唯一标识符。

ICalendarPublishEnabled

如果为 True, 则为计划启用 ICalendar 共享。有关详细信息, 请参阅查看日历上的任务

OptedInNotifications

用户选择加入的通知。

OptedOutNotifications

用户选择退出的通知。

FavoritePlans

供用户使用的计划书签收藏。

User.FavoritePlans.Id

计划的 Microsoft Planner ID。

FavoritePlans 书签名

分配给书签的名称。

FavoritePlans OrderHint

用于排序顺序。请参阅在 Microsoft Planner 中使用订单提示

RecentPlans

用户最近打开的计划。

User.RecentPlans.Id

计划的 Microsoft Planner ID。

RecentPlans 书签名

分配给书签的名称。

RecentPlans LastAccess

上次打开计划的时间。

用户. UserData

来自 Planner Web 客户端的自定义数据。

用户. UserData 密钥

自定义数据键。

用户. UserData. 值

自定义数据值。

AssignedTaskOrdering

分配给用户的任务的排序顺序。

AssignedTaskOrdering PlanId

包含任务的计划的 Microsoft Planner ID。

User.AssignedTaskOrdering.Id

Microsoft Planner 任务的 ID。

AssignedTaskOrdering 的订单

用于排序顺序。请参阅在 Microsoft Planner 中使用订单提示

AssignedTaskOrdering 标题

任务的标题。

计划文件

每个计划文件名都以 "plan" 为前缀, 并带有计划的 Microsoft Planner ID。每个文件都将具有以下属性:

属性

说明

Plan.Id

计划的 Microsoft Planner ID。

计划标题

计划的标题。

计划所有者

计划的所有者 (组或用户实体)。

Plan.Owner.Id

Microsoft Planner 实体 (组或用户) 的 ID。

ExternalId 的所有者

实体 (组或用户) 的 Azure Active Directory ID。

计划、所有者、DisplayName

所有者 (组或用户) 的显示名称。

计划的所有者 UserPrincipalName

用户主体名称 (UPN) (如果所有者是用户)。

PrincipalType 的所有者

实体类型 (组或用户)。

CreatedDate

创建计划的日期和时间。

CreatedBy

创建计划的用户。有关更多详细信息, 请参阅用户属性

CreatedByAppId

创建计划的应用的唯一标识符。

ModifiedDate

上次更新计划的日期和时间。

ModifiedBy

上次更新计划的用户的名称。有关更多详细信息, 请参阅用户属性

PlanDetailsId

计划详细信息对象的唯一标识符。

ICalendarPublishEnabled

如果为 True, 则为计划启用 ICalendar 共享。有关详细信息, 请参阅查看日历上的任务

CreateTaskCommentWhen

将导致为计划中的任务创建评论的事件。

ReferencesToPlan

链接到计划的外部系统。例如, 在 Project Online 桌面客户端中嵌入 Microsoft Planner 计划。

ReferencesToPlan ExternalId

此计划的外部系统的 ID。

ReferencesToPlan

计划的链接类型, 由外部应用指定。

ReferencesToPlan CreatedDate

创建引用对象的日期和时间。

ReferencesToPlan OwnerAppId

创建引用的应用的 ID。

ReferencesToPlan DisplayNameSegments

描述此计划引用内容的位置的痕迹导航。

ReferencesToPlan

指向引用该计划的应用的直接链接。

CategoryDescriptions

计划的完整类别集。 其中有六个, 可能正在使用, 也可能未使用。

CategoryDescriptions 的计划

类别说明的索引 (0 到 5)。

CategoryDescriptions 说明

相应类别说明索引值的标签文本。

PlanFollowers

遵循计划的用户。

TimelineId

该功能已被弃用。

TimelineDisplaySettings

该功能已被弃用。

TimelineLockedWidth

该功能已被弃用。

计划。任务

计划的任务对象。

Plan.Tasks.Id

任务的唯一标识符。

计划, 任务。标题

任务的名称。

计划 BucketId

该任务所在存储桶的 Microsoft Planner ID。

计划 BucketName

存储桶的名称。

计划. 百分比的任务。

任务的完成状态, 从0到100。

计划任务。开始日期

计划开始任务的日期。

计划表达式 iif

计划完成任务的日期。

计划 ConversationThreadId

来自 Microsoft Exchange 的对话唯一标识符。

计划 PreviewType

显示在任务卡片上的预览。

计划 OrderHint

用于排序顺序。请参阅在 Microsoft Planner 中使用订单提示

计划 CreatedBy

创建该任务的用户。有关更多详细信息, 请参阅用户属性

计划 CreatedDate

创建任务的日期。

计划 CompletedBy

完成任务的用户。有关更多详细信息, 请参阅用户属性

计划 CompletedDate

完成任务的日期。

计划 ModifiedBy

上次更新任务的用户。有关更多详细信息, 请参阅用户属性

计划 ModifiedDate

上次更新任务的日期。

计划 AppliedCategories

从计划的 CategoryDescriptions 索引中选择的标签。

计划 TaskDetailsId

任务的详细信息对象的唯一标识符。

计划。任务。描述

任务的说明。

计划 AssignedToTaskBoardFormatId

作为任务版块格式的对象的唯一标识符。

计划 AssignedToTaskBoardFormatUnassignedOrderHint

用于排序顺序。请参阅在 Microsoft Planner 中使用订单提示

计划 AssignedToTaskBoardFormatOrderHintsByAssignee

每个代理人的订单提示。

计划 AssignedToTaskBoardFormatOrderHintsByAssignee:

分配了该任务的用户。有关更多详细信息, 请参阅用户属性

AssignedToTaskBoardFormatOrderHintsByAssignee 订单

"分配给" 视图中由 "受托人" 指定的任务的排序。

计划 BucketTaskBoardFormatId

作为 bucket 任务版块格式的对象的唯一标识符。

计划 BucketTaskBoardFormatOrderHint

用于排序顺序。请参阅在 Microsoft Planner 中使用订单提示

计划 ProgressTaskBoardFormatId

按进度进行分组时, 而不是使用存储桶格式的对象的唯一标识符。

计划 ProgressTaskBoardFormatOrderHint

用于排序顺序。请参阅在 Microsoft Planner 中使用订单提示

计划 TimelineFormatId

该功能已被弃用。

计划 TimelineFormatShowOnTimeline

该功能已被弃用。

计划 TimelineFormatAnchorPosition

该功能已被弃用。

计划 TimelineFormatCalloutHeight

该功能已被弃用。

计划 TimelineFormatColor

该功能已被弃用。

计划 TimelineFormatDrawingStyle

该功能已被弃用。

计划 TimelineFormatLabelOffsetX

该功能已被弃用。

计划 TimelineFormatLabelOffsetY

该功能已被弃用。

计划 TimelineFormatSwimlane

该功能已被弃用。

计划、任务和引用

外部链接。

计划、任务、Url

链接的 URL。

计划. 引用. 别名

链接的文本说明

计划。引用。键入

要链接到的文件的类型。

ModifiedBy 中的 "计划" 任务。

上次更新链接的用户。有关更多详细信息, 请参阅用户属性

ModifiedDate 中的 "计划" 任务。

上次更新链接的日期。

PreviewPriority 中的 "计划" 任务。

表示要在 UI 中的任务上显示为预览的引用的优先级。Microsoft Planner 仅显示最高优先级项目。

计划、任务和工作分配

任务分配。

计划. 分配的任务。分配给

向其分配任务的用户。有关更多详细信息, 请参阅用户属性

计划、作业 AssignedBy

分配了该任务的用户。有关更多详细信息, 请参阅用户属性

计划、任务和工作分配。订单

任务分配给多个实体时的顺序。

规划、任务清单

任务的清单。

Plan.Tasks.Checklist.Id

核对清单项的唯一标识符。

规划、任务清单和标题

核对清单项的名称。

计划 OrderHint 的任务清单。

用于排序顺序。请参阅在 Microsoft Planner 中使用订单提示

计划 IsChecked 的任务清单。

如果为 true, 则已完成核对清单项。

计划 ModifiedBy 的任务清单。

上次更新清单的用户。有关更多详细信息, 请参阅用户属性

计划 ModifiedDate 的任务清单。

上次更新清单的日期。

计划存储桶

计划的存储桶对象。

Plan.Buckets.Id

存储桶的唯一标识符。

计划存储桶. 标题

存储桶的名称。

计划存储桶. OrderHint

用于排序顺序。请参阅在 Microsoft Planner 中使用订单提示

计划存储桶. Createdby

创建存储桶的用户。有关更多详细信息, 请参阅用户属性

计划存储桶. CreatedDate

创建存储桶的日期。

计划存储桶. ModifiedBy

上次更新存储桶的用户。有关更多详细信息, 请参阅用户属性

计划存储桶. ModifiedDate

上次更新存储桶的日期。

"计划 json" 文件中的用户属性

计划中有许多对象, 它表示 Microsoft Planner 用户并具有类似的属性。这些对象包括:

  • CreatedBy

  • ModifiedBy

  • PlanFollowers

  • 计划 CreatedBy

  • 计划 CompletedBy

  • 计划 ModifiedBy

  • 计划 AssignedToTaskBoardFormatOrderHintsByAssignee 分配给您的任务

  • ModifiedBy 中的 "计划" 任务。

  • 计划. 分配的任务。分配给

  • 计划、作业 AssignedBy

  • 计划 ModifiedBy

  • 计划 Createdby

  • 计划 Modifiedby

以上每个都将具有以下属性:

属性

说明

Id

Microsoft Planner 用户 ID。

ExternalId

用户的 Azure Active Directory ID。

DisplayName

用户的显示名称。

UserPrincipalName

用户的用户主体名称 (UPN)。

PrincipalType

实体类型 ("用户" 或 "组")。

另请参阅

在 Microsoft Planner 中删除用户数据

扩展你的 Office 技能
了解培训
抢先获得新功能
加入 Office 预览体验计划

此信息是否有帮助?

谢谢您的反馈!

谢谢你的反馈! 可能需要转接到 Office 支持专员。

×