Leggere in inglese

Condividi tramite


Esportare i dati degli utenti da Microsoft Planner

Importante

Questo articolo si applica a:

  • Piani di base nell'app Planner in Teams
  • Tutti i piani in altri endpoint di Planner (inclusi Planner connettori Web, Planner per dispositivi mobili e Planner)

Non si applica agli elenchi Attività o ai piani Premium nell'app Planner in Teams. Altre informazioni sull'app Planner in Teams

L'articolo descrive in che modo un amministratore globale può esportare i dati per uno specifico utente da Microsoft Planner. I dati esportati includono i dati sull'utente contenuti in Planner e anche i dati contenuti nei piani di cui l'utente faceva parte. Il processo di esportazione si esegue tramite Windows PowerShell.

Nota

Un amministratore globale può esportare i dati di telemetria degli utenti di Microsoft Planner tramite lo strumento di esportazione di log di dati in Microsoft Service Trust Portal.

Prerequisiti per apportare modifiche a Planner in Windows PowerShell

Seguire la procedura descritta in Prerequisiti per apportare modifiche a Planner in Windows PowerShell per apportare modifiche a Planner in Windows PowerShell.

Per esportare il contenuto utente da Planner

  1. Da Windows PowerShell, usare il cmdlet Export-PlannerUserContent per esportare il contenuto utente da Planner.

    Export-PlannerUserContent -UserAadIdOrPrincipalName <user's AADId or UPN> -ExportDirectory <output location>
    
    Parametro Descrizione
    UserAadIdOrPrincipalName Usare il Microsoft Entra ID o l'UPN dell'utente per cui si vuole esportare il contenuto.
    ExportDirectory Posizione in cui archiviare i file di output. La cartella deve esistere già.
    HostName È necessario usare questo parametro solo se si accede a Planner tramite un nome host diverso dall'attività.ufficio.com. Ad esempio, se si accede a Planner tramite attività.office365.us, includere le attività -HostName.office365.us nel comando.

    Ad esempio, il comando seguente consente di esportare le informazioni utente di Adam Barr da Planner usando il suo UPN e scaricare i file di esportazione nel percorso C:\PlannerExportAdamBarr.

     Export-PlannerUserContent -UserAadIdOrPrincipalName adambarr@contoso.onmicrosoft.com -ExportDirectory C:\PlannerExportAdamBarr
    
  2. Verrà richiesto di eseguire l'autenticazione. Accedere come utente (amministratore globale) e non come utente da esportare.

  3. Dopo l'esecuzione corretta del cmdlet di PowerShell, passare al percorso di esportazione per visualizzare i file di dati dell'utente esportati.

Dati che vengono esportati e come leggerli

Dopo aver eseguito il cmdlet di PowerShell per esportare i dati dell'utente da Planner, si riceveranno due tipi di file nella cartella del percorso di download:

  • Un singolo file utente in formato JSON con informazioni sull'utente.
  • Un file JSON per ogni piano in cui l'utente:
    • Ha un'attività assegnata.
    • Ha creato un'attività.

Come leggere i file esportati

È possibile usare le informazioni in questa sezione per comprendere le proprietà che verranno visualizzate nei file json ricevuti sia dall'utente che dal piano.

File utente

Il nome file dell'utente inizierà con il prefisso "User" e l'ID di Microsoft Planner dell'utente. Avrà le proprietà seguenti:

Proprietà Descrizione
User.Id ID di Microsoft Planner dell'utente.
User.ExternalId Microsoft Entra ID dell'utente.
User.DisplayName Nome visualizzato dell'utente.
User.InternalDisplayName Nome visualizzato di Microsoft Planner dell'utente.
User.UserPrincipalName Nome dell'entità utente (UPN) dell'utente.
User.PrincipalType Il valore è sempre "Utente".
User.UserDetailsId Identificatore univoco dell'oggetto dettagli per l'utente.
User.ICalendarPublishEnabled Se è True, la condivisione ICalendar è abilitata per il piano. Per altre informazioni, vedere Visualizzare il calendario di Planner in Outlook.
User.OptedInNotifications Notifiche per cui l'utente ha dato il consenso esplicito.
User.OptedOutNotifications Notifiche per cui l'utente ha rifiutato esplicitamente il consenso.
User.FavoritePlans Segnalibro per i piani che l'utente ha incluso tra i preferiti.
User.FavoritePlans.Id ID di Microsoft Planner del piano.
User.FavoritePlans.BookmarkName Nome assegnato al segnalibro.
User.FavoritePlans.OrderHint Usato per l'ordinamento. Vedere l'articolo sull'uso dei suggerimenti per l'ordinamento in Microsoft Planner.
User.RecentPlans Piani aperti di recente dall'utente.
User.RecentPlans.Id ID di Microsoft Planner del piano.
User.RecentPlans.BookmarkName Nome assegnato al segnalibro.
User.RecentPlans.LastAccess Data dell'ultima apertura del piano.
User.UserData Dati personalizzati del client Web di Planner.
User.UserData.Key Chiave dati personalizzata.
User.UserData.Value Valore dati personalizzato.
User.AssignedTaskOrdering Ordinamento per le attività assegnate all'utente.
User.AssignedTaskOrdering.PlanId ID di Microsoft Planner del piano che contiene l'attività.
User.AssignedTaskOrdering.Id ID di Microsoft Planner dell'attività.
User.AssignedTaskOrdering.Order Usato per l'ordinamento. Vedere l'articolo sull'uso dei suggerimenti per l'ordinamento in Microsoft Planner.
User.AssignedTaskOrdering.Title Titolo dell'attività.

File dei piani

Il nome file di ogni piano inizierà con il prefisso "Plan" e l'ID di Microsoft Planner del piano. Ogni file avrà le proprietà seguenti:

Proprietà Descrizione
Plan.Id ID di Microsoft Planner del piano.
Plan.Title Titolo del piano.
Nota: i piani con il titolo RosterPlaceholderPlan_{89F9907E-D21D-4C90-A4B8-7A76CF3E6F70} indicano che il file corrente rappresenta un elenco creato ma al suo interno non è ancora stato creato un piano.
Plan.Owner Proprietario del piano (un'entità gruppo o utente).
Plan.Owner.Id ID di Microsoft Planner dell'entità (gruppo o utente).
Plan.Owner.ExternalId Microsoft Entra ID dell'entità (gruppo o utente).
Plan.Owner.DisplayName Nome visualizzato del proprietario (gruppo o utente).
Plan.Owner.UserPrincipalName Nome dell'entità utente (UPN) se il proprietario è un utente.
Plan.Owner.PrincipalType Tipo di entità (gruppo o utente).
Plan.Container Contenitore per il piano.
Plan.Container.ContainerType Tipo di contenitore (gruppo, elenco partecipanti).
Plan.Container.ExternalId Microsoft Entra ID del gruppo.
Plan.Container.Description Nome visualizzato del gruppo.
Plan.CreatedDate Data e ora di creazione del piano.
Plan.CreatedBy Utente che ha creato il piano. Per altre informazioni, vedere Proprietà utente.
Plan.ModifiedDate Data e ora dell'ultimo aggiornamento del piano.
Plan.ModifiedBy Nome dell'ultimo utente che ha aggiornato il piano. Per altre informazioni, vedere Proprietà utente.
Plan.PlanDetailsId Identificatore univoco dell'oggetto dettagli del piano.
Plan.ICalendarPublishEnabled Se è True, la condivisione ICalendar è abilitata per il piano. Per altre informazioni, vedere le attività in un calendario .
Plan.CreateTaskCommentWhen Eventi che comporteranno la creazione di un commento per un'attività nel piano.
Plan.ReferencesToPlan Sistemi esterni collegati al piano. Ad esempio, se si incorpora un piano di Microsoft Planner nel client desktop di Project Online.
Plan.ReferencesToPlan.ExternalId ID del sistema esterno per il piano.
Plan.ReferencesToPlan.AssociationType Tipo di collegamento al piano, specificato dall'app esterna.
Plan.ReferencesToPlan.CreatedDate Data e ora di creazione dell'oggetto riferimento.
Plan.ReferencesToPlan.CustomLinkText Testo utilizzabile per la visualizzazione dell'URL.
Plan.ReferencesToPlan.DisplayAs Specifica come presentare in un'esperienza utente i dati di riferimento come l'URL.
Plan.ReferencesToPlan.IsCreationContext È impostato su true se il riferimento è stato impostato durante la creazione del piano.
Plan.ReferencesToPlan.OwnerAppId ID dell'app che ha creato il riferimento.
Plan.ReferencesToPlan.DisplayNameSegments Percorsi di navigazione della posizione che descrive cosa fa riferimento al piano.
Plan.ReferencesToPlan.Url Collegamento diretto all'app che fa riferimento al piano.
Plan.CategoryDescriptions Set completo di categorie per il piano.
Plan.CategoryDescriptions.Index Indice della descrizione categoria.
Plan.CategoryDescriptions.Description Testo dell'etichetta per il valore di indice della descrizione categoria corrispondente.
Plan.PlanFollowers Se Plan.Container.ContainerType è impostato su Group, questo campo indica gli utenti che seguono il piano. Se Plan.Container.ContainerType è impostato su Roster, questo campo indica gli utenti inclusi nell'elenco partecipanti.
Plan.TimelineId Questa funzionalità è stata deprecata.
Plan.TimelineDisplaySettings Questa funzionalità è stata deprecata.
Plan.TimelineLockedWidth Questa funzionalità è stata deprecata.
Plan.Tasks Oggetti attività per il piano.
Plan.Tasks.Id Identificatore univoco dell'attività.
Plan.Tasks.Title Nome dell'attività.
Plan.Tasks.BucketId ID di Microsoft Planner del contenitore in cui si trova l'attività.
Plan.Tasks.BucketName Nome del contenitore.
Plan.Tasks.PercentComplete Stato di completamento dell'attività, da 0 a 100.
Plan.Tasks.StartDate Data pianificata per l'inizio dell'attività.
Plan.Tasks.DueDate Data pianificata per il completamento dell'attività.
Plan.Tasks.ConversationThreadId Identificatore univoco della conversazione da Microsoft Exchange.
Plan.Tasks.PreviewType Anteprima visualizzata nella scheda attività.
Plan.Tasks.OrderHint Usato per l'ordinamento. Vedere l'articolo sull'uso dei suggerimenti per l'ordinamento in Microsoft Planner.
Plan.Tasks.CreatedBy Utente che ha creato l'attività. Per altre informazioni, vedere Proprietà utente.
Plan.Tasks.CreatedDate Data di creazione dell'attività.
Plan.Tasks.CompletedBy Utente che ha completato l'attività. Per altre informazioni, vedere Proprietà utente.
Plan.Tasks.CompletedDate Data di completamento dell'attività.
Plan.Tasks.ModifiedBy Ultimo utente che ha aggiornato l'attività. Per altre informazioni, vedere Proprietà utente.
Plan.Tasks.ModifiedDate Data dell'ultimo aggiornamento dell'attività.
Plan.Tasks.AppliedCategories Etichette selezionate dall'indice CategoryDescriptions per il piano.
Plan.Tasks.Recurrence Definisce la ricorrenza attiva o inattiva per l'attività. null quando la ricorrenza non è mai stata definita per l'attività.
Plan.Tasks.Recurrence.SeriesId La serie di ricorrenza a cui appartiene questa attività. Valore basato su GUID che funge da identificatore univoco per una serie.
Plan.Tasks.Recurrence.OccurrenceIndex Indice basato su 1 di questa attività all'interno della serie di ricorrenza. La prima attività di una serie ha il valore 1, l'attività successiva della serie ha il valore 2e così via.
Plan.Tasks.Recurrence.PreviousInSeriesTaskId ID attività dell'attività precedente in questa serie. null per la prima attività di una serie perché non ha predecessori. Ogni attività successiva della serie ha un valore corrispondente al predecessore.
Plan.Tasks.Recurrence.NextInSeriesTaskId ID attività dell'attività successiva in questa serie. Questo valore viene assegnato al momento della creazione dell'attività successiva nella serie ed è null precedente a tale data.
Plan.Tasks.Recurrence.RecurrenceStartDate Data e ora di inizio della serie di ricorrenza. Per la prima attività di una serie (OccurrenceIndex = 1) questo valore corrisponde a Schedule.Range.StartDate. Per le attività successive della serie (OccurrenceIndex>= 2) questo valore viene copiato dall'attività precedente e non viene mai modificato. Mantiene la data di inizio della serie ricorrente.
Plan.Tasks.Recurrence.Schedule Pianificazione per la ricorrenza. null indica che la ricorrenza è stata annullata. Si noti che se viene assegnato NextInSeriesTaskId , questo valore di pianificazione verrà mantenuto come snapshot dell'aspetto della pianificazione al momento del completamento dell'attività.
Plan.Tasks.Recurrence.Schedule.Pattern Modello per la ricorrenza. Il modello, insieme a Schedule.Range, viene usato per calcolare Schedule.NextOccurrenceDate.
Plan.Tasks.Recurrence.Schedule.Pattern.IsDailyCadence True per la cadenza giornaliera (nel qual caso DaysOrDates è vuoto). False in caso contrario ,ovvero per cadenza settimanale, mensile o annuale.
Plan.Tasks.Recurrence.Schedule.Pattern.Interval Intervallo applicato al tipo di cadenza. I valori maggiori di 1 indicano che un punto verrà ignorato. Esempi: per un modello Daily, un intervallo di 2 indica che le attività si ripeteranno ogni due giorni (o ogni altro giorno). Per un modello mensile, un intervallo di 3 indica che le attività si ripeteranno ogni tre mesi (noto anche come trimestrale).
Plan.Tasks.Recurrence.Schedule.Pattern.DaysOrDates Ogni voce in questa raccolta rappresenta la definizione esattamente di un giorno o di una data. Esempio: "FixedYearly,August,15" indica il 15 agosto dell'anno. "FloatingMonthly,Second,Monday" significa il secondo lunedì del mese. "Weekly,Wednesday","Weekly,Friday" indica ogni settimana il mercoledì e il venerdì.
Plan.Tasks.Recurrence.Schedule.Pattern.FirstDayOfWeek Il primo giorno della settimana (in genere domenica); questo viene usato solo dai modelli settimanali ed è null per modelli non settimanali.
Plan.Tasks.Recurrence.Schedule.Range Specifica quando viene avviata e terminata la ricorrenza.
Plan.Tasks.Recurrence.Schedule.Range.StartDate Data da cui deve iniziare l'oggetto Recurrence.Schedule . Questo valore può essere aggiornato dagli utenti quando si apportano modifiche a Recurrence.Schedule.Pattern.
Plan.Tasks.Recurrence.Schedule.Range.Kind Attualmente l'unico valore supportato è NoEnd, che indica che la serie non terminerà automaticamente.
Plan.Tasks.Recurrence.Schedule.NextOccurrenceDate Data successiva per questo oggetto Recurrence.Schedule. Quando viene creata un'istanza di una nuova attività per continuare la serie di ricorrenza, questa data viene usata per duedate della nuova attività.
Plan.Tasks.TaskDetailsId Identificatore univoco dell'oggetto dettagli per l'attività.
Plan.Tasks.Description Descrizione dell'attività.
Plan.Tasks.AssignedToTaskBoardFormatId Identificatore univoco per l'oggetto che rappresenta il formato della bacheca delle attività.
Plan.Tasks.AssignedToTaskBoardFormatUnassignedOrderHint Usato per l'ordinamento. Vedere l'articolo sull'uso dei suggerimenti per l'ordinamento in Microsoft Planner.
Plan.Tasks.AssignedToTaskBoardFormatOrderHintsByAssignee Suggerimento per l'ordinamento per ogni assegnatario.
Plan.Tasks.AssignedToTaskBoardFormatOrderHintsByAssignee.AssignedTo: Utente a cui è assegnata l'attività. Per altre informazioni, vedere Proprietà utente.
Plan.Tasks.AssignedToTaskBoardFormatOrderHintsByAssignee.Order Ordinamento delle attività specificato dall'assegnatario nella visualizzazione Assegnata a.
Plan.Tasks.BucketTaskBoardFormatId Identificatore univoco per l'oggetto che rappresenta il formato della bacheca delle attività del contenitore.
Plan.Tasks.BucketTaskBoardFormatOrderHint Usato per l'ordinamento. Vedere l'articolo sull'uso dei suggerimenti per l'ordinamento in Microsoft Planner.
Plan.Tasks.ProgressTaskBoardFormatId Identificatore univoco per l'oggetto, se raggruppato in base allo stato di avanzamento anziché al formato del contenitore.
Plan.Tasks.ProgressTaskBoardFormatOrderHint Usato per l'ordinamento. Vedere l'articolo sull'uso dei suggerimenti per l'ordinamento in Microsoft Planner.
Plan.Tasks.TimelineFormatId Questa funzionalità è stata deprecata.
Plan.Tasks.TimelineFormatShowOnTimeline Questa funzionalità è stata deprecata.
Plan.Tasks.TimelineFormatAnchorPosition Questa funzionalità è stata deprecata.
Plan.Tasks.TimelineFormatCalloutHeight Questa funzionalità è stata deprecata.
Plan.Tasks.TimelineFormatColor Questa funzionalità è stata deprecata.
Plan.Tasks.TimelineFormatDrawingStyle Questa funzionalità è stata deprecata.
Plan.Tasks.TimelineFormatLabelOffsetX Questa funzionalità è stata deprecata.
Plan.Tasks.TimelineFormatLabelOffsetY Questa funzionalità è stata deprecata.
Plan.Tasks.TimelineFormatSwimlane Questa funzionalità è stata deprecata.
Plan.Tasks.References Collegamenti esterni.
Plan.Tasks.References.Url URL del collegamento.
Plan.Tasks.References.Alias Descrizione testuale del collegamento.
Plan.Tasks.References.Type Tipo di file collegato.
Plan.Tasks.References.ModifiedBy Ultimo utente che ha aggiornato il collegamento. Per altre informazioni, vedere Proprietà utente.
Plan.Tasks.References.ModifiedDate Data dell'ultimo aggiornamento del collegamento.
Plan.Tasks.References.PreviewPriority Rappresenta la priorità di un riferimento da mostrare come anteprima dell'attività nell'interfaccia utente. Microsoft Planner mostra solo l'elemento con la priorità più alta.
Plan.Tasks.Assignments Assegnazioni di attività.
Plan.Tasks.Assignments.AssignedTo Utente a cui è assegnata quell'attività. Per altre informazioni, vedere Proprietà utente.
Plan.Tasks.Assignments.AssignedBy Utente che ha assegnato l'attività. Per altre informazioni, vedere Proprietà utente.
Plan.Tasks.Assignments.Order Ordine delle assegnazioni se l'attività è assegnata a più entità.
Plan.Tasks.Checklist Elenco di controllo per l'attività.
Plan.Tasks.Checklist.Id Identificatore univoco di una voce dell'elenco di controllo.
Plan.Tasks.Checklist.Title Nome della voce dell'elenco di controllo.
Plan.Tasks.Checklist.OrderHint Usato per l'ordinamento. Vedere l'articolo sull'uso dei suggerimenti per l'ordinamento in Microsoft Planner.
Plan.Tasks.Checklist.IsChecked Se è True, la voce dell'elenco di controllo è stata completata.
Plan.Tasks.Checklist.ModifiedBy Ultimo utente che ha aggiornato l'elenco di controllo. Per altre informazioni, vedere Proprietà utente.
Plan.Tasks.Checklist.ModifiedDate Data dell'ultimo aggiornamento dell'elenco di controllo.
Plan.Tasks.UserContentLastModifiedBy Ultimo utente che ha aggiornato l'attività o i dettagli attività. Per altre informazioni, vedere Proprietà utente.
Plan.Tasks.UserContentLastModifiedDate Data dell'ultimo aggiornamento dell'attività o dei dettagli attività.
Plan.Buckets Oggetti contenitore per il piano.
Plan.Buckets.Id Identificatore univoco del contenitore.
Plan.Buckets.Title Nome del contenitore.
Plan.Buckets.OrderHint Usato per l'ordinamento. Vedere l'articolo sull'uso dei suggerimenti per l'ordinamento in Microsoft Planner.
Plan.Buckets.Createdby Utente che ha creato il contenitore. Per altre informazioni, vedere Proprietà utente.
Plan.Buckets.CreatedDate Data di creazione del contenitore.
Plan.Buckets.ModifiedBy Ultimo utente che ha aggiornato il contenitore. Per altre informazioni, vedere Proprietà utente.
Plan.Buckets.ModifiedDate Data dell'ultimo aggiornamento del contenitore.

Proprietà utente nel file Plans.json

Esistono molti oggetti nei dati Plans.json che rappresentano un utente Microsoft Planner e avranno proprietà simili. Questi oggetti includono:

  • 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

Ognuno degli oggetti elencati avrà le proprietà seguenti:

Proprietà Descrizione
ID ID di Microsoft Planner dell'utente.
ExternalId Microsoft Entra ID dell'utente.
DisplayName Nome visualizzato dell'utente.
UserPrincipalName Nome dell'entità utente (UPN) dell'utente.
PrincipalType Tipo di entità (utente o gruppo).

Eliminare i dati degli utenti in Microsoft Planner