Share via

從 Microsoft Planner 匯出使用者資料

  • 文章

重要事項

本文適用於：

  • Teams 中 Planner 應用程式中的基本方案
  • 其他 Planner 端點中的所有方案 (包括 Planner Web、Planner 行動裝置和 Planner 連接器)

不適用於 Teams 中 Planner 應用程式中的 [To Do] 清單或進階方案。 深入瞭解 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 識別碼。 該檔案具有下列屬性：

屬性 描述
User.Id 使用者的 Microsoft Planner 識別碼。
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 識別碼。
User.FavoritePlans.BookmarkName 書籤的指派名稱。
User.FavoritePlans.OrderHint 用於排序。 請參閱使用 Microsoft Planner 中的順序提示。
User.RecentPlans 使用者最近開啟的計劃。
User.RecentPlans.Id 計劃的 Microsoft Planner 識別碼。
User.RecentPlans.BookmarkName 書籤的指派名稱。
User.RecentPlans.LastAccess 上次開啟計劃的時間。
User.UserData Planner Web 用戶端的自訂資料。
User.UserData.Key 自訂的資料索引鍵。
User.UserData.Value 自訂的資料值。
User.AssignedTaskOrdering 指派給使用者的工作排序。
User.AssignedTaskOrdering.PlanId 包含工作的計劃的 Microsoft Planner 識別碼。
User.AssignedTaskOrdering.Id 工作的 Microsoft Planner 識別碼。
User.AssignedTaskOrdering.Order 用於排序。 請參閱使用 Microsoft Planner 中的順序提示。
User.AssignedTaskOrdering.Title 工作的標題。

計劃檔案

每個計劃檔案的名稱前會加上 "Plan" 和計劃的 Microsoft Planner 識別碼。 每個檔案都會具有下列屬性：

屬性 描述
Plan.Id 計劃的 Microsoft Planner 識別碼。
Plan.Title 計劃的標題。
注意：標題為 RosterPlaceholderPlan_{89F9907E-D21D-4C90-A4B8-7A76CF3E6F70} 的方案表示目前的檔案代表已建立但尚未在其中建立方案的名冊。
Plan.Owner 計劃的擁有者 (群組或使用者實體)。
Plan.Owner.Id 實體 (群組或使用者) 的 Microsoft Planner 識別碼。
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 建立計劃的使用者。 如需更多詳細資料，請查看 User 屬性。
Plan.ModifiedDate 上次更新計劃的日期和時間。
Plan.ModifiedBy 上次更新計劃的使用者名稱。 如需更多詳細資料，請查看 User 屬性。
Plan.PlanDetailsId 計劃詳細資料物件的唯一識別碼。
Plan.ICalendarPublishEnabled 若為 True，則會啟用計劃的 ICalendar 共用。 如需詳細資訊，請參閱 行事曆上 的工作。
Plan.CreateTaskCommentWhen 會在計劃的工作中建立註解的事件。
Plan.ReferencesToPlan 連結至計劃的外部系統。 例如，將 Microsoft Planner 計劃嵌入 Project Online 電腦版用戶端。
Plan.ReferencesToPlan.ExternalId 此計劃的外部系統識別碼。
Plan.ReferencesToPlan.AssociationType 由外部應用程式指定的計劃連結類型。
Plan.ReferencesToPlan.CreatedDate 參照物件建立的日期和時間。
Plan.ReferencesToPlan.CustomLinkText 顯示 URL 時可以使用的文字。
Plan.ReferencesToPlan.DisplayAs 指定參考資料如 URL 應在使用者體驗中呈現的方式。
Plan.ReferencesToPlan.IsCreationContext 如果該參考是在建立計劃時設定，則設為 true。
Plan.ReferencesToPlan.OwnerAppId 建立參照的應用程式識別碼。
Plan.ReferencesToPlan.DisplayNameSegments 描述此計劃參照目標的位置階層連結。
Plan.ReferencesToPlan.Url 參照此計劃的應用程式直接連結。
Plan.CategoryDescriptions 計劃的完整類別集。
Plan.CategoryDescriptions.Index 類別描述的索引。
Plan.CategoryDescriptions.Description 對應類別描述索引值的標籤文字。
Plan.PlanFollowers 如果 Plan.Container.ContainerType 為 Group，則此欄位是追蹤計劃的使用者。 如果 Plan.Container.ContainerType 為 Roster，則此欄位是名冊的成員使用者。
Plan.TimelineId 已被取代的功能。
Plan.TimelineDisplaySettings 已被取代的功能。
Plan.TimelineLockedWidth 已被取代的功能。
Plan.Tasks 計劃的工作物件。
Plan.Tasks.Id 工作的唯一識別碼。
Plan.Tasks.Title 工作名稱。
Plan.Tasks.BucketId 工作所在貯體的 Microsoft Planner 識別碼。
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 建立工作的使用者。 如需更多詳細資料，請查看 User 屬性。
Plan.Tasks.CreatedDate 建立工作的日期。
Plan.Tasks.CompletedBy 完成工作的使用者。 如需更多詳細資料，請查看 User 屬性。
Plan.Tasks.CompletedDate 完成工作的日期。
Plan.Tasks.ModifiedBy 上次更新工作的使用者。 如需更多詳細資料，請查看 User 屬性。
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 本系列中上一個任務的工作 標識 碼。 null 用於系列中的第一個任務，因為它沒有前置任務。 數列中的每個後續工作都有對應於其前置任務的值。
Plan.Tasks.Recurrence.NextInSeriesTaskId 本系列中下一個任務的工作 標識 碼。 這個值會在建立數列中的下一個工作時指派，而且在 null 該時間之前。
Plan.Tasks.Recurrence.RecurrenceStartDate 此週期序列開始的日期和時間。 對於 (OccurrenceIndex = 1 系列中的第一個工作) 此值會對應至 Schedule.Range.StartDate。 對於 series (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: 獲派工作的使用者。 如需更多詳細資料，請查看 User 屬性。
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 上次更新連結的使用者。 如需更多詳細資料，請查看 User 屬性。
Plan.Tasks.References.ModifiedDate 上次更新連結的日期。
Plan.Tasks.References.PreviewPriority 表示要在 UI 中的工作上顯示為預覽的參照優先順序。 Microsoft Planner 只會顯示優先順序最高的項目。
Plan.Tasks.Assignments 工作指派。
Plan.Tasks.Assignments.AssignedTo 獲派工作的使用者。 如需更多詳細資料，請查看 User 屬性。
Plan.Tasks.Assignments.AssignedBy 獲派工作的使用者。 如需更多詳細資料，請查看 User 屬性。
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 上次更新檢查清單的使用者。 如需更多詳細資料，請查看 User 屬性。
Plan.Tasks.Checklist.ModifiedDate 上次更新檢查清單的日期。
Plan.Tasks.UserContentLastModifiedBy 上次更新工作或工作詳細資料的使用者。 如需更多詳細資料，請查看 User 屬性。
Plan.Tasks.UserContentLastModifiedDate 上次更新工作或工作詳細資料的日期。
Plan.Buckets 計劃的貯體物件。
Plan.Buckets.Id 貯體的唯一識別碼。
Plan.Buckets.Title 貯體名稱。
Plan.Buckets.OrderHint 用於排序。 請參閱使用 Microsoft Planner 中的順序提示。
Plan.Buckets.Createdby 建立貯體的使用者。 如需更多詳細資料，請查看 User 屬性。
Plan.Buckets.CreatedDate 建立貯體的日期。
Plan.Buckets.ModifiedBy 上次更新貯體的使用者。 如需更多詳細資料，請查看 User 屬性。
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

每個物件都會具有下列屬性：

屬性 描述
識別碼 使用者的 Microsoft Planner 識別碼。
ExternalId 使用者的 Microsoft Entra ID。
DisplayName 使用者的顯示名稱。
UserPrincipalName 使用者的使用者主體名稱 (UPN)。
PrincipalType 實體類型 (使用者或群組)。

在 Microsoft Planner 中刪除使用者資料