从 Microsoft Planner 中导出用户数据

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

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

要求

您需要首先执行以下操作:

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

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

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

取消阻止您的文件

你将需要 "取消阻止" 用户数据导出脚本包中下载的三个文件, 才能在 PowerShell 中使用它们。 这是因为默认情况下, 不允许执行从 Internet 下载的脚本。 您需要取消阻止的文件有:

  • plannertenantadmin.psm1

  • identitymodel 的客户端

  • windowsforms 的 identitymodel 的链接

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

  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

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

    -主机名

    仅当通过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

值始终为 "User"。

UserDetailsId

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

ICalendarPublishEnabled

如果为 True, 则为计划启用 ICalendar 共享。 有关详细信息, 请参阅 Outlook 中的 Planner 日历

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。值

自定义数据值。

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

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

计划: 所有者

用户主体名称 (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

存储桶任务板格式的对象的唯一标识符。

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

上次更新清单的日期。

UserContentLastModifiedBy

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

UserContentLastModifiedDate

上次更新任务或任务详细信息的日期。

计划存储桶  

计划的存储桶对象。

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 支持专员。

×