Exportar dados do usuário do Microsoft Planner
Importante
Este artigo se aplica ao:
- Planos básicos no aplicativo Planner no Teams
- Todos os planos em outros pontos de extremidade Planner (incluindo Planner Web, Planner conectores móveis e Planner)
Ele não se aplica a listas De Fazer ou planos premium no aplicativo Planner no Teams. Saiba mais sobre o aplicativo Planner no Teams
Este artigo descreve como um administrador global pode exportar dados de um usuário específico do Microsoft Planner. Os dados exportados incluem dados sobre o usuário contido em Planner e também dados contidos nos planos dos quais o usuário fazia parte. O processo de exportação é feito por meio do Windows PowerShell.
Observação
Um administrador global pode exportar dados de telemetria do usuário provenientes do Microsoft Planner por meio da Ferramenta de Exportação de Logs de Dados no Portal de Confiabilidade do Serviço da Microsoft.
Pré-requisitos para fazer alterações no Planner no Windows PowerShell
Siga os etapas em Pré-requisitos para fazer alterações no Planner no Windows PowerShell para fazer alterações no Planner no Windows PowerShell.
Para exportar o conteúdo do usuário do Planner
A partir do Windows PowerShell, usar o cmdlet Export-PlannerUserContent para exportar o conteúdo de seu usuário a partir do Planner.
Export-PlannerUserContent -UserAadIdOrPrincipalName <user's AADId or UPN> -ExportDirectory <output location>
Parâmetro Descrição UserAadIdOrPrincipalName Use o Microsoft Entra ID ou o UPN do usuário para o qual você deseja exportar conteúdo. ExportDirectory Local para armazenar os arquivos de saída. A pasta já deve existir. HostName Você só precisa usar esse parâmetro se acessar Planner por meio de um nome de host diferente da tarefa.Escritório.com. Por exemplo, se você acessar Planner por meio de tarefas.office365.nós, inclua -Tarefas do HostName.office365.us em seu comando. Por exemplo, os itens a seguir exportam as informações de usuário de Fábio Pena do Planner usando seu UPN e baixará os arquivos de exportação para o local C:\PlannerExportFabioPena.
Export-PlannerUserContent -UserAadIdOrPrincipalName adambarr@contoso.onmicrosoft.com -ExportDirectory C:\PlannerExportAdamBarr
Sua autenticação será solicitada. Entre como você (o administrador global), não o usuário que você deseja exportar.
Após o cmdlet do PowerShell ser executado com êxito, vá para o local de exportação para exibir os arquivos de dados exportados do usuário.
O que é exportado e como ler
Depois de executar o cmdlet do PowerShell para exportar os dados do usuário de Planner, você receberá dois tipos de arquivos na pasta de localização de download:
- Um único arquivo de usuário no formato json com informações sobre o usuário.
- Um arquivo json para cada plano no qual o usuário:
- Tiver uma tarefa atribuída a eles.
- Tiver uma tarefa atribuída por eles.
Como ler os arquivos exportados
Você pode usar as informações nesta seção para ajudar a entender as propriedades que você verá no usuário e planejar arquivos json que recebeu.
Arquivo do usuário
O nome do arquivo do usuário será antecedido por "User" e a ID do usuário no Microsoft Planner. Tem as seguintes propriedades:
Propriedade | Descrição |
---|---|
User.Id | ID do usuário no Microsoft Planner. |
User.ExternalId | Microsoft Entra ID do usuário. |
User.DisplayName | Nome de exibição do usuário. |
User.InternalDisplayName | Nome de exibição do usuário no Microsoft Planner. |
User.UserPrincipalName | O UPN (nome principal) desse usuário. |
User.PrincipalType | O valor é sempre "Usuário". |
User.UserDetailsId | Identificador exclusivo do objeto de detalhes do usuário. |
User.ICalendarPublishEnabled | Se for Verdadeiro, o compartilhamento do ICalendar estará habilitado para o plano. Confira Ver o calendário do Planner no Outlook para obter mais informações. |
User.OptedInNotifications | Notificações que o usuário aceitou. |
User.OptedOutNotifications | Notificações que o usuário recusou. |
User.FavoritePlans | Indicadores de planos que o usuário adicionou aos favoritos. |
User.FavoritePlans.Id | ID do plano no Microsoft Planner. |
User.FavoritePlans.BookmarkName | O nome atribuído ao indicador. |
User.FavoritePlans.OrderHint | Usado na ordem de classificação. Confira Usar dicas de ordenação no Microsoft Planner. |
User.RecentPlans | Planos abertos recentemente pelo usuário. |
User.RecentPlans.Id | ID do plano no Microsoft Planner. |
User.RecentPlans.BookmarkName | O nome atribuído ao indicador. |
User.RecentPlans.LastAccess | Quando o plano foi aberto pela última vez. |
User.UserData | Dados personalizados do cliente Web do Planner. |
User.UserData.Key | Chave dos dados personalizados. |
User.UserData.Value | Valor dos dados personalizados. |
User.AssignedTaskOrdering | Ordem de classificação das tarefas do Planner atribuídas ao usuário. |
User.AssignedTaskOrdering.PlanId | ID do plano que contém a tarefa no Microsoft Planner. |
User.AssignedTaskOrdering.Id | ID da tarefa no Microsoft Planner. |
User.AssignedTaskOrdering.Order | Usado na ordem de classificação. Confira Usar dicas de ordenação no Microsoft Planner. |
User.AssignedTaskOrdering.Title | Título da tarefa. |
Planejar arquivos
O nome do arquivo de cada plano será antecedido por "Plan" e a ID do plano no Microsoft Planner. Cada arquivo tem as seguintes propriedades:
Propriedade | Descrição |
---|---|
Plan.Id | ID do plano no Microsoft Planner. |
Plan.Title | Título do plano. Observação: planos com o título RosterPlaceholderPlan_{89F9907E-D21D-4C90-A4B8-7A76CF3E6F70} indicam que o arquivo atual representa uma Lista que foi criada, mas ainda não tem um plano criado dentro dele. |
Plan.Owner | Proprietário do plano (um grupo ou uma entidade de usuário). |
Plan.Owner.Id | ID da entidade (grupo ou usuário) no Microsoft Planner. |
Plan.Owner.ExternalId | Microsoft Entra ID da entidade (Grupo ou Usuário). |
Plan.Owner.DisplayName | Exibir o nome do proprietário (grupo ou usuário). |
Plan.Owner.UserPrincipalName | O UPN (nome UPN) se o proprietário for um usuário. |
Plan.Owner.PrincipalType | O tipo de entidade (grupo ou usuário). |
Plan.Container | Contêiner para o plano. |
Plan.Container.ContainerType | O tipo de contêiner (Grupo, Lista). |
Plan.Container.ExternalId | Microsoft Entra ID do grupo. |
Plan.Container.Description | Exibir o nome do grupo. |
Plan.CreatedDate | Data e hora em que o arquivo foi criado. |
Plan.CreatedBy | O usuário que criou o plano. Confira as propriedades do usuário para obter mais detalhes. |
Plan.ModifiedDate | Data e hora da última atualização do plano. |
Plan.ModifiedBy | Nome do usuário que atualizou o plano pela última vez. Confira as propriedades do usuário para obter mais detalhes. |
Plan.PlanDetailsId | Identificador exclusivo do objeto de detalhes do plano. |
Plan.ICalendarPublishEnabled | Se for Verdadeiro, o compartilhamento do ICalendar estará habilitado para o plano. Consulte suas tarefas em um calendário para obter mais informações. |
Plan.CreateTaskCommentWhen | Os eventos que causarão a criação de um comentário para uma tarefa no plano. |
Plan.ReferencesToPlan | Sistemas externos com links para o plano. Por exemplo, inserir um plano do Microsoft Planner no cliente de desktop online do Project. |
Plan.ReferencesToPlan.ExternalId | ID desse plano no sistema externo. |
Plan.ReferencesToPlan.AssociationType | O tipo de link para o plano especificado pelo aplicativo externo. |
Plan.ReferencesToPlan.CreatedDate | Data e hora em que o objeto de referência foi criado. |
Plan.ReferencesToPlan.CustomLinkText | Texto que pode ser usado ao exibir o Url. |
Plan.ReferencesToPlan.DisplayAs | Especifica como os dados de referência como o Url devem ser apresentados em uma experiência do usuário. |
Plan.ReferencesToPlan.IsCreationContext | Definido para true se a referência foi definida quando o Plano foi criado. |
Plan.ReferencesToPlan.OwnerAppId | ID do aplicativo que criou a referência. |
Plan.ReferencesToPlan.DisplayNameSegments | Trilhas do local que descrevem quais são as referências a esse plano. |
Plan.ReferencesToPlan.Url | Link direto para o aplicativo que faz referência ao plano. |
Plan.CategoryDescriptions | O conjunto completo de categorias para o plano. |
Plan.CategoryDescriptions.Index | O índice da descrição da categoria. |
Plan.CategoryDescriptions.Description | O texto do rótulo com o valor de índice da descrição da categoria correspondente. |
Plan.PlanFollowers | Se o Plan.Container.ContainerType for um Group, então este campo são os Usuários que seguem o plano. Se o Plan.Container.ContainerType for uma Lista de participantes, então este campo são os Usuários que são membros da Lista. |
Plan.TimelineId | O recurso foi preterido. |
Plan.TimelineDisplaySettings | O recurso foi preterido. |
Plan.TimelineLockedWidth | O recurso foi preterido. |
Plan.Tasks | Objetos de tarefas para o plano. |
Plan.Tasks.Id | Identificador exclusivo da tarefa. |
Plan.Tasks.Title | Nome da tarefa. |
Plan.Tasks.BucketId | ID do bucket no qual está a tarefa do Microsoft Planner. |
Plan.Tasks.BucketName | Nome do bucket. |
Plan.Tasks.PercentComplete | Status de conclusão da tarefa, de 0 a 100. |
Plan.Tasks.StartDate | Data em que a tarefa está programada para começar. |
Plan.Tasks.DueDate | Data em que a tarefa está programada para terminar. |
Plan.Tasks.ConversationThreadId | Identificador exclusivo da conversa do Microsoft Exchange. |
Plan.Tasks.PreviewType | Visualização exibida no cartão de tarefas. |
Plan.Tasks.OrderHint | Usado na ordem de classificação. Confira Usar dicas de ordenação no Microsoft Planner. |
Plan.Tasks.CreatedBy | O usuário que criou a tarefa. Confira as propriedades do usuário para obter mais detalhes. |
Plan.Tasks.CreatedDate | Data de criação da tarefa. |
Plan.Tasks.CompletedBy | Usuário que concluiu a tarefa. Confira as propriedades do usuário para obter mais detalhes. |
Plan.Tasks.CompletedDate | Data em que a tarefa foi concluída. |
Plan.Tasks.ModifiedBy | Usuário que atualizou a tarefa pela última vez. Confira as propriedades do usuário para obter mais detalhes. |
Plan.Tasks.ModifiedDate | Data da última atualização da tarefa. |
Plan.Tasks.AppliedCategories | Os rótulos selecionados no índice CategoryDescriptions para o plano. |
Plan.Tasks.Recurrence | Define a recorrência ativa ou inativa para a tarefa. null quando a recorrência nunca foi definida para a tarefa. |
Plan.Tasks.Recurrence.SeriesId | A série de recorrência à qual essa tarefa pertence. Um valor baseado em GUID que serve como o identificador exclusivo para uma série. |
Plan.Tasks.Recurrence.OccurrenceIndex | O índice baseado em 1 dessa tarefa na série de recorrência. A primeira tarefa em uma série tem o valor 1 , a próxima tarefa da série tem o valor 2 e assim por diante. |
Plan.Tasks.Recurrence.PreviousInSeriesTaskId | A ID da tarefa anterior nesta série. null para a primeira tarefa em uma série, já que não tem nenhum antecessor. Cada tarefa subsequente na série tem um valor correspondente ao seu antecessor. |
Plan.Tasks.Recurrence.NextInSeriesTaskId | A ID da tarefa seguinte nesta série. Esse valor é atribuído no momento em que a próxima tarefa da série é criada e é null anterior a essa hora. |
Plan.Tasks.Recurrence.RecurrenceStartDate | A data e a hora em que essa série de recorrência começou. Para a primeira tarefa em uma série (OccurrenceIndex = 1 ), esse valor corresponde a Schedule.Range.StartDate. Para tarefas subsequentes na série (OccurrenceIndex>= 2 ) esse valor é copiado da tarefa anterior e nunca é alterado; preserva a data de início da série recorrente. |
Plan.Tasks.Recurrence.Schedule | A agenda de recorrência. null indica que a recorrência foi cancelada. Observe que, se NextInSeriesTaskId for atribuído, esse valor de agendamento será preservado como uma instantâneo de como era a agenda no momento da conclusão dessa tarefa. |
Plan.Tasks.Recurrence.Schedule.Pattern | O padrão de recorrência. O padrão, juntamente com Schedule.Range, são usados para calcular o Schedule.NextOccurrenceDate. |
Plan.Tasks.Recurrence.Schedule.Pattern.IsDailyCadence | True para a cadência diária (nesse caso , DaysOrDates está vazio). False caso contrário (ou seja, para cadência semanal, mensal ou anual). |
Plan.Tasks.Recurrence.Schedule.Pattern.Interval | O intervalo aplicado ao tipo de cadência. Valores maiores que 1 significam que um período será ignorado. Exemplos: para um padrão diário, um intervalo de 2 significa que as tarefas serão retomadas a cada dois dias (ou a cada dois dias). Para um padrão mensal, um intervalo de 3 significa que as tarefas se repetirão a cada três meses (também conhecido como trimestral). |
Plan.Tasks.Recurrence.Schedule.Pattern.DaysOrDates | Cada entrada nesta coleção representa a definição de exatamente um dia ou data. Exemplo: "FixedYearly,August,15" significa em 15 de agosto do ano. "FloatingMonthly,Second,Monday" significa na segunda segunda-feira do mês. "Weekly,Wednesday","Weekly,Friday" significa semanalmente às quartas e sextas-feiras. |
Plan.Tasks.Recurrence.Schedule.Pattern.FirstDayOfWeek | O primeiro dia da semana (normalmente domingo); isso é usado apenas por padrões semanais e é null para padrões não semanais. |
Plan.Tasks.Recurrence.Schedule.Range | Especifica quando a recorrência é iniciada e termina. |
Plan.Tasks.Recurrence.Schedule.Range.StartDate | A data da qual a Recorrência.Agenda deve começar. Esse valor pode ser atualizado pelos usuários ao fazer alterações no Recurrence.Schedule.Pattern. |
Plan.Tasks.Recurrence.Schedule.Range.Kind | Atualmente, o único valor com suporte é NoEnd , indicando que a série não terminará automaticamente. |
Plan.Tasks.Recurrence.Schedule.NextOccurrenceDate | A próxima data para esta Recorrência.Agenda. Quando uma nova tarefa é instanciada para continuar a série de recorrência, essa data é usada para o DueDate da nova Tarefa. |
Plan.Tasks.TaskDetailsId | O identificador exclusivo do objeto de detalhes da tarefa. |
Plan.Tasks.Description | Descrição da tarefa. |
Plan.Tasks.AssignedToTaskBoardFormatId | Identificador exclusivo do objeto no formato do quadro de tarefas. |
Plan.Tasks.AssignedToTaskBoardFormatUnassignedOrderHint | Usado na ordem de classificação. Confira Usar dicas de ordenação no Microsoft Planner. |
Plan.Tasks.AssignedToTaskBoardFormatOrderHintsByAssignee | Dica de ordenação para cada um dos assinantes. |
Plan.Tasks.AssignedToTaskBoardFormatOrderHintsByAssignee.AssignedTo: | O usuário para o qual a tarefa está atribuída. Confira as propriedades do usuário para obter mais detalhes. |
Plan.Tasks.AssignedToTaskBoardFormatOrderHintsByAssignee.Order | Ordem das tarefas especificadas por assinante na exibição Atribuído a. |
Plan.Tasks.BucketTaskBoardFormatId | Identificador exclusivo do objeto no formato do quadro de tarefas do bucket. |
Plan.Tasks.BucketTaskBoardFormatOrderHint | Usado na ordem de classificação. Confira Usar dicas de ordenação no Microsoft Planner. |
Plan.Tasks.ProgressTaskBoardFormatId | Identificador exclusivo do objeto quando agrupado por andamento, em vez de usar o formato de bucket. |
Plan.Tasks.ProgressTaskBoardFormatOrderHint | Usado na ordem de classificação. Confira Usar dicas de ordenação no Microsoft Planner. |
Plan.Tasks.TimelineFormatId | O recurso foi preterido. |
Plan.Tasks.TimelineFormatShowOnTimeline | O recurso foi preterido. |
Plan.Tasks.TimelineFormatAnchorPosition | O recurso foi preterido. |
Plan.Tasks.TimelineFormatCalloutHeight | O recurso foi preterido. |
Plan.Tasks.TimelineFormatColor | O recurso foi preterido. |
Plan.Tasks.TimelineFormatDrawingStyle | O recurso foi preterido. |
Plan.Tasks.TimelineFormatLabelOffsetX | O recurso foi preterido. |
Plan.Tasks.TimelineFormatLabelOffsetY | O recurso foi preterido. |
Plan.Tasks.TimelineFormatSwimlane | O recurso foi preterido. |
Plan.Tasks.References | Links externos. |
Plan.Tasks.References.Url | A URL do link. |
Plan.Tasks.References.Alias | Descrição em texto do link. |
Plan.Tasks.References.Type | O tipo de arquivo ao qual é vinculado. |
Plan.Tasks.References.ModifiedBy | Usuário que atualizou o link pela última vez. Confira as propriedades do usuário para obter mais detalhes. |
Plan.Tasks.References.ModifiedDate | Data da última atualização do link. |
Plan.Tasks.References.PreviewPriority | Representa a prioridade de uma referência a ser mostrada como uma visualização da tarefa na interface do usuário. O Microsoft Planner mostra somente o item de prioridade mais alta. |
Plan.Tasks.Assignments | Atribuições da tarefa. |
Plan.Tasks.Assignments.AssignedTo | O usuário para o qual a tarefa foi atribuída. Confira as propriedades do usuário para obter mais detalhes. |
Plan.Tasks.Assignments.AssignedBy | O usuário que atribuiu a tarefa. Confira as propriedades do usuário para obter mais detalhes. |
Plan.Tasks.Assignments.Order | Ordem das tarefas se a tarefa for atribuída a várias entidades. |
Plan.Tasks.Checklist | A lista de verificação da tarefa. |
Plan.Tasks.Checklist.Id | Identificador exclusivo de um item da lista de verificação. |
Plan.Tasks.Checklist.Title | Nome do item na lista de verificação. |
Plan.Tasks.Checklist.OrderHint | Usado na ordem de classificação. Confira Usar dicas de ordenação no Microsoft Planner. |
Plan.Tasks.Checklist.IsChecked | Se for verdadeiro, o item da lista de verificação foi concluído. |
Plan.Tasks.Checklist.ModifiedBy | O usuário que atualizou a lista de verificação pela última vez. Confira as Propriedades do usuário para obter mais detalhes. |
Plan.Tasks.Checklist.ModifiedDate | Data em que a lista de verificação foi atualizada pela última vez. |
Plan.Tasks.UserContentLastModifiedBy | Usuário que atualizou a tarefa ou os detalhes da tarefa pela última vez. Confira as Propriedades do usuário para obter mais detalhes. |
Plan.Tasks.UserContentLastModifiedDate | Data em que a tarefa ou os detalhes da tarefa foram atualizados pela última vez. |
Plan.Buckets | Objetos de bucket para o plano. |
Plan.Buckets.Id | Identificador exclusivo do bucket. |
Plan.Buckets.Title | Nome do bucket. |
Plan.Buckets.OrderHint | Usado na ordem de classificação. Confira Usar dicas de ordenação no Microsoft Planner. |
Plan.Buckets.Createdby | O usuário que criou o bucket. Confira as Propriedades do usuário para obter mais detalhes. |
Plan.Buckets.CreatedDate | Data de criação do bucket. |
Plan.Buckets.ModifiedBy | Usuário que atualizou o bucket pela última vez. Confira as Propriedades do usuário para obter mais detalhes. |
Plan.Buckets.ModifiedDate | Data da última atualização do bucket. |
Propriedades do usuário no arquivo Plans.json
Há muitos objetos em Plans.json dados que representam um usuário Microsoft Planner e terão propriedades semelhantes. Esses objetos incluem:
- 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
Cada arquivo acima tem as seguintes propriedades:
Propriedade | Descrição |
---|---|
ID | ID do usuário no Microsoft Planner. |
ExternalId | Microsoft Entra ID do usuário. |
DisplayName | Nome de exibição do usuário. |
UserPrincipalName | O UPN (nome principal) desse usuário. |
PrincipalType | O tipo de entidade (usuário ou grupo). |