Microsoft Planner からユーザー データをエクスポートする
この記事では、全体管理者が、Microsoft Planner から特定のユーザーのデータをエクスポートする方法について説明します。 エクスポートされたデータには、Planner に含まれるユーザーに関するデータと、そのユーザーが含まれているプランに含まれているデータが含まれます。 エクスポート プロセスは Windows PowerShell 経由で実行されます。
注:
全体管理者は、Microsoft Planner ユーザーのテレメトリ データを Microsoft Service Trust Portal のデータ ログのエクスポート ツールを使用してエクスポートできます。
Windows PowerShell で Planner を変更するための前提条件
Windows PowerShell で Planner を変更するには、「Windows PowerShell で Planner を変更するための前提条件」の手順に従う必要があります。
Planner からユーザー コンテンツをエクスポートするには
Windows PowerShell で、Export-PlannerUserContent Export コマンドレットを使用して 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認証を求められます。 エクスポートするユーザーとしてではなく、全体管理者としてログインします。
PowerShell コマンドレットが正常に実行されたら、エクスポート先の場所に移動して、ユーザーのエクスポート データ ファイルを確認します。
エクスポートされる内容および内容を解釈する方法
PowerShell コマンドレットを実行してユーザーのデータを Planner からエクスポートすると、ダウンロード場所のフォルダーに 2 種類のファイルが追加されます。
- ユーザーに関する情報を含む、JSON 形式のユーザー ファイル 1 つ。
- 次のようなプラン 1 つにつき 1 つの 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 | プランにリンクしている外部システム。 たとえば、Microsoft Planner のプランを Project Online デスクトップ クライアントに埋め込む場合。 |
| 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 | このシリーズの前のタスクのタスク ID 。 null 先行タスクがないため、シリーズの最初のタスクの場合は 。 系列内の後続の各タスクには、その先行タスクに対応する値があります。 |
| Plan.Tasks.Recurrence.NextInSeriesTaskId | このシリーズの次のタスクのタスク ID 。 この値は、系列の次のタスクが作成された時点で割り当てられ、 null その時刻より前です。 |
| Plan.Tasks.Recurrence.RecurrenceStartDate | この繰り返し系列が開始された日時。 系列の最初のタスク (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 は、タスクが 2 日 (または 1 日おき) ごとに繰り返されることを意味します。 月単位のパターンの場合、[間隔 3] は、タスクが 3 か月 (別名四半期) ごとに繰り返されることを意味します。 |
| Plan.Tasks.Recurrence.Schedule.Pattern.DaysOrDates | このコレクションの各エントリは、正確に 1 日または日付の定義を表します。 例: "FixedYearly,August,15" 年の 8 月 15 日を意味します。 "FloatingMonthly,Second,Monday" は、月の第 2 月曜日を意味します。 "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 | この 繰り返しの次の日付。スケジュール。 新しいタスクをインスタンス化して繰り返し系列を続行すると、この日付が新しいタスクの 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 ファイルに含まれるユーザー プロパティ
Microsoft Planner のユーザーを表す Plans.json データ内には多数のオブジェクトが含まれ、似通ったプロパティを持ちます。 次のオブジェクトが含まれます。
- 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 | エンティティの種類 (ユーザーまたはグループ)。 |