Share via

Экспорт данных пользователя из Планировщика (Майкрософт)

  • Статья

Важно!

Эта статья относится к:

  • Базовые планы в приложении Планировщик в Teams
  • Все планы в других конечных точках Планировщик (включая Планировщик веб-, Планировщик мобильные и соединители Планировщик)

Это не относится к спискам задач или планам уровня "Премиум" в приложении Планировщик в Teams. Дополнительные сведения о приложении Планировщик в Teams

В этой статье описано, как глобальный администратор может экспортировать данные для определенного пользователя из Планировщика (Майкрософт). Экспортированные данные включают данные о пользователе, содержащиеся в Планировщик, а также данные, содержащиеся в планах, частью которыми был пользователь. Экспорт выполняется с помощью Windows PowerShell.

Примечание.

Глобальный администратор может экспортировать данные телеметрии пользователя из Планировщика (Майкрософт) с помощью средства экспорта журнала данных на портале Microsoft Service Trust Portal.

Предварительные требования для внесения изменений в Планировщик в Windows PowerShell

Выполните действия из статьи Предварительные требования для внесения изменений в Планировщик в Windows PowerShell, чтобы внести изменения в Планировщик из Windows PowerShell.

Экспорт содержимого пользователя из Планировщика

  1. Используйте командлет Export-PlannerUserContent в Windows PowerShell, чтобы экспортировать содержимое пользователя из Планировщика.

    Export-PlannerUserContent -UserAadIdOrPrincipalName <user's AADId or UPN> -ExportDirectory <output location>
    Параметр Описание
    UserAadIdOrPrincipalName Используйте Microsoft Entra ID или имя участника-пользователя, для которого требуется экспортировать содержимое.
    ExportDirectory Расположение для хранения выходных файлов. Папка уже должна существовать.
    HostName Этот параметр необходимо использовать только при доступе к Планировщик через имя узла, отличное от задачи.Офис.com. Например, если вы обращаетесь к Планировщик через задачи.office365.мы, включая задачи -HostName.office365.us в вашей команде.

    Например, следующая команда экспортирует сведения пользователя Adam Barr из Планировщика с помощью его имени участника-пользователя (UPN) и скачивает файлы экспорта в папку C:\PlannerExportAdamBarr.

     Export-PlannerUserContent -UserAadIdOrPrincipalName adambarr@contoso.onmicrosoft.com -ExportDirectory C:\PlannerExportAdamBarr

  2. Появится запрос на проверку подлинности. Войдите от имени себя (глобального администратора), а не от имени пользователя, который вы хотите экспортировать.

  3. После успешного выполнения командлета PowerShell перейдите в папку экспорта, чтобы просмотреть файлы экспортированных данных пользователя.

Экспортируемые элементы и способ их чтения

После выполнения командлета PowerShell для экспорта данных пользователя из Планировщик вы получите два типа файлов в папке расположения для скачивания:

  • Отдельный файл пользователя в формате JSON, содержащий сведения о пользователе.
  • Один JSON-файл для каждого плана, в котором:
    • Пользователю назначена задача.
    • Пользователем создана задача.

Чтение экспортированных файлов

Сведения, приведенные в этом разделе, помогут вам понять свойства, которые будут отображаться в полученных файлах JSON для пользователей и планов.

Файл пользователя

Имя файла пользователя будет содержать префикс User и идентификатор пользователя из Планировщика (Майкрософт). В нем есть следующие свойства:

Свойство Описание
User.Id Идентификатор пользователя в Планировщике (Майкрософт).
User.ExternalId Microsoft Entra ID пользователя.
User.DisplayName Отображаемое имя пользователя.
User.InternalDisplayName Отображаемое имя пользователя в Планировщике (Майкрософт).
User.UserPrincipalName Имя участника-пользователя.
User.PrincipalType Значение всегда — "Пользователь".
User.UserDetailsId Уникальный идентификатор объекта сведений для пользователя.
User.ICalendarPublishEnabled Если указано значение True, для плана включен общий доступ с помощью ICalendar. Дополнительные сведения см. в статье Просмотр календаря Планировщика в Outlook.
User.OptedInNotifications Уведомления, которые выбрал пользователь.
User.OptedOutNotifications Уведомления, от которых отказался пользователь.
User.FavoritePlans Закладка для планов, помеченных пользователем в качестве избранного.
User.FavoritePlans.Id Идентификатор плана в Планировщике (Майкрософт).
User.FavoritePlans.BookmarkName Имя, присвоенное закладке.
User.FavoritePlans.OrderHint Используется для порядка сортировки. См. статью Использование подсказок порядка в Планировщике (Майкрософт).
User.RecentPlans Планы, недавно открывавшиеся пользователем.
User.RecentPlans.Id Идентификатор плана в Планировщике (Майкрософт).
User.RecentPlans.BookmarkName Имя, присвоенное закладке.
User.RecentPlans.LastAccess Дата последнего открытия плана.
User.UserData Пользовательские данные из веб-клиента Планировщика.
User.UserData.Key Ключ пользовательских данных.
User.UserData.Value Значение пользовательских данных.
User.AssignedTaskOrdering Порядок сортировки для задач, назначенных пользователю.
User.AssignedTaskOrdering.PlanId Идентификатор содержащего задачу плана в Планировщике (Майкрософт).
User.AssignedTaskOrdering.Id Идентификатор задачи в Планировщике (Майкрософт).
User.AssignedTaskOrdering.Order Используется для порядка сортировки. См. статью Использование подсказок порядка в Планировщике (Майкрософт).
User.AssignedTaskOrdering.Title Название задачи.

Файлы планов

Имя файла каждого плана будет содержать префикс Plan и идентификатор плана из Планировщика (Майкрософт). В каждом файле есть следующие свойства:

Свойство Описание
Plan.Id Идентификатор плана в Планировщике (Майкрософт).
Plan.Title Название плана.
Примечание. Планы с заголовком RosterPlaceholderPlan_{89F9907E-D21D-4C90-A4B8-7A76CF3E6F70} указывают, что текущий файл представляет список, который был создан, но в нем еще не создан план.
Plan.Owner Владелец плана (объект Group или User).
Plan.Owner.Id Идентификатор объекта в Планировщике (Майкрософт)(группы или пользователя).
Plan.Owner.ExternalId Microsoft Entra ID сущности (группа или пользователь).
Plan.Owner.DisplayName Отображаемое имя владельца (группы или пользователя).
Plan.Owner.UserPrincipalName Имя участника-пользователя, если владельцем является пользователь.
Plan.Owner.PrincipalType Тип объекта (группа или пользователь).
Plan.Container Контейнер для плана.
Plan.Container.ContainerType Тип контейнера (группа, состав).
Plan.Container.ExternalId Microsoft Entra ID группы.
Plan.Container.Description Отображаемое имя группы.
Plan.CreatedDate Дата и время создания плана.
Plan.CreatedBy Пользователь, создавший план. Дополнительные сведения см. в разделе "Свойства пользователя".
Plan.ModifiedDate Дата и время последнего изменения плана.
Plan.ModifiedBy Имя пользователя, последним обновившего план. Дополнительные сведения см. в разделе "Свойства пользователя".
Plan.PlanDetailsId Уникальный идентификатор объекта сведений о плане.
Plan.ICalendarPublishEnabled Если указано значение True, для плана включен общий доступ с помощью ICalendar. Дополнительные сведения см. в разделе о задачах в календаре .
Plan.CreateTaskCommentWhen События, приводящие к созданию примечания для задачи в плане.
Plan.ReferencesToPlan Внешние системы, связанные с планом. Например, внедрение плана Планировщика (Майкрософт) в классический клиент 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 является группа, в этом поле указываются пользователи, подписанные на план. Если типом Plan.Container.ContainerType является состав, в этом поле указываются пользователи из этого состава.
Plan.TimelineId Функция устарела.
Plan.TimelineDisplaySettings Функция устарела.
Plan.TimelineLockedWidth Функция устарела.
Plan.Tasks Объекты задач для плана.
Plan.Tasks.Id Уникальный идентификатор задачи.
Plan.Tasks.Title Имя задачи.
Plan.Tasks.BucketId Идентификатор содержащего задачу сегмента в Планировщике (Майкрософт).
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 Используется для порядка сортировки. См. статью Использование подсказок порядка в Планировщике (Майкрософт).
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 Идентификатор предыдущей задачи в этом ряду. null для первой задачи в ряду, так как она не имеет предшественника. Каждая последующая задача в ряде имеет значение, соответствующее его предшественнику.
Plan.Tasks.Recurrence.NextInSeriesTaskId Идентификатор следующей задачи в этом ряду. Это значение присваивается при создании следующей задачи в ряде и до null этого времени.
Plan.Tasks.Recurrence.RecurrenceStartDate Дата и время начала этого ряда повторений. Для первой задачи в ряду (OccurrenceIndex = 1) это значение соответствует Schedule.Range.StartDate. Для последующих задач в ряду (OccurrenceIndex>= 2) это значение копируется из предыдущей задачи и никогда не меняется; оно сохраняет дату начала повторяющегося ряда.
Plan.Tasks.Recurrence.Schedule Расписание повторения. null указывает, что повторение отменено. Обратите внимание, что если назначен параметр NextInSeriesTaskId, это значение расписания будет сохранено как snapshot того, как выглядело расписание на момент завершения этой задачи.
Plan.Tasks.Recurrence.Schedule.Pattern Шаблон повторения. Шаблон, а также Schedule.Range используются для вычисления параметра Schedule.NextOccurrenceDate.
Plan.Tasks.Recurrence.Schedule.Pattern.IsDailyCadence True для ежедневной частоты (в этом случае пуста дата DayOrDates ). False в противном случае (то есть для еженедельной, ежемесячной или ежегодной частоты).
Plan.Tasks.Recurrence.Schedule.Pattern.Interval Интервал, применяемый к типу частоты. Значения больше 1 означают, что период будет пропущен. Примеры: для шаблона Ежедневно интервал 2 означает, что задачи будут повторяться каждые два дня (или через день). Для ежемесячного шаблона интервал 3 означает, что задачи будут повторяться каждые три месяца (ежеквартально).
Plan.Tasks.Recurrence.Schedule.Pattern.DaysOrDates Каждая запись в этой коллекции представляет определение ровно одного дня или даты. Пример: "FixedYearly,August,15" означает 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 Используется для порядка сортировки. См. статью Использование подсказок порядка в Планировщике (Майкрософт).
Plan.Tasks.AssignedToTaskBoardFormatOrderHintsByAssignee Подсказка порядка для каждого исполнителя.
Plan.Tasks.AssignedToTaskBoardFormatOrderHintsByAssignee.AssignedTo: Пользователь, которому назначена задача. Дополнительные сведения см. в разделе "Свойства пользователя".
Plan.Tasks.AssignedToTaskBoardFormatOrderHintsByAssignee.Order Порядок задач, указанный исполнителем в представлении "Кому назначено".
Plan.Tasks.BucketTaskBoardFormatId Уникальный идентификатор объекта, являющегося форматом доски задач "Сегменты".
Plan.Tasks.BucketTaskBoardFormatOrderHint Используется для порядка сортировки. См. статью Использование подсказок порядка в Планировщике (Майкрософт).
Plan.Tasks.ProgressTaskBoardFormatId Уникальный идентификатор объекта при группировке по ходу выполнения, а не по сегментам.
Plan.Tasks.ProgressTaskBoardFormatOrderHint Используется для порядка сортировки. См. статью Использование подсказок порядка в Планировщике (Майкрософт).
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 Представляет приоритет ссылки, отображаемый при предварительном просмотре задачи в пользовательском интерфейсе. В Планировщике (Майкрософт) отображается только элемент с наивысшим приоритетом.
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 Используется для порядка сортировки. См. статью Использование подсказок порядка в Планировщике (Майкрософт).
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 Используется для порядка сортировки. См. статью Использование подсказок порядка в Планировщике (Майкрософт).
Plan.Buckets.Createdby Пользователь, создавший сегмент. Дополнительные сведения см. в разделе Свойства пользователя.
Plan.Buckets.CreatedDate Дата создания сегмента.
Plan.Buckets.ModifiedBy Пользователь, последним обновивший сегмент. Дополнительные сведения см. в разделе Свойства пользователя.
Plan.Buckets.ModifiedDate Дата последнего обновления сегмента.

Свойства пользователя в файле Plans.json

В данных 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

Каждый из указанных выше объектов имеет следующие свойства:

Свойство Описание
ИД Идентификатор пользователя в Планировщике (Майкрософт).
ExternalId Microsoft Entra ID пользователя.
DisplayName Отображаемое имя пользователя.
UserPrincipalName Имя участника-пользователя.
PrincipalType Тип объекта (пользователь или группа).

Удаление данных пользователя в Планировщике (Майкрософт)