Exportación de datos de usuario de Microsoft Planner
Importante
Este artículo se aplica a:
- Planes básicos en la aplicación Planner en Teams
- Todos los planes de otros puntos de conexión de Planner (incluidos Planner web, Planner conectores móviles y Planner)
No se aplica a las listas de tareas pendientes ni a los planes premium de la aplicación Planner en Teams. Más información sobre la aplicación Planner en Teams
En este artículo se describe cómo un administrador global puede exportar datos de un usuario específico de Microsoft Planner. Los datos exportados incluyen datos sobre el usuario contenidos en Planner y también datos contenidos en los planes de los que formaba parte el usuario. El proceso de exportación se realiza mediante Windows PowerShell.
Nota:
Un administrador global puede exportar datos de telemetría de usuarios de Microsoft Planner mediante la Herramienta exportación de registros de datos en el Portal de confianza del servicio de Microsoft.
Requisitos previos para realizar cambios en Planner mediante Windows PowerShell
Para realizar cambios de Planner en Windows PowerShell, necesitará seguir los pasos de Requisitos previos para realizar cambios de Planner en Windows PowerShell
Exportar contenido de usuario de Planner
Desd Windows PowerShell, use el cmdlet Export-PlannerUserContent para exportar el contenido del usuario de Planner.
Export-PlannerUserContent -UserAadIdOrPrincipalName <user's AADId or UPN> -ExportDirectory <output location>Parámetro Descripción UserAadIdOrPrincipalName Use el Microsoft Entra ID o el UPN del usuario para el que desea exportar contenido. ExportDirectory La ubicación para almacenar los archivos de salida. La carpeta ya debería existir. HostName Solo tiene que usar este parámetro si accede a Planner a través de un nombre de host distinto de task.Oficina.com. Por ejemplo, si accede a Planner a través de tareas.office365.us, incluya -HostName tasks.office365.us en su comando. Por ejemplo, a continuación se exportará la información de usuario de Adam Barr de Planner con su UPN y se descargarán los archivos de exportación en la ubicación C:\PlannerExportAdamBarr.
Export-PlannerUserContent -UserAadIdOrPrincipalName adambarr@contoso.onmicrosoft.com -ExportDirectory C:\PlannerExportAdamBarrSe le pedirá que se autentique. Inicie sesión como usted mismo (el administrador global), no como el usuario que desea exportar.
Después de que el cmdlet de PowerShell se haya ejecutado correctamente, vaya a la ubicación de exportación para ver los archivos de datos exportados del usuario.
¿Qué se exporta y cómo se lee?
Después de ejecutar el cmdlet de PowerShell para exportar los datos del usuario desde Planner, recibirá dos tipos de archivos en la carpeta de ubicación de descarga:
- Un archivo de usuario único en formato JSON con información sobre el usuario.
- Un archivo JSON para cada plan en el que el usuario:
- Tiene una tarea asignada.
- Tiene una tarea creada.
Cómo leer los archivos exportados
Puede usar la información de esta sección para ayudarle a comprender las propiedades que verá en los archivos json de usuario y plan que ha recibido.
Archivo de usuario
Se asignará a cada nombre de archivo de plan el prefijo "User" y el Id. de Microsoft Planner del usuario. Tendrá las siguientes propiedades:
| Propiedad | Descripción |
|---|---|
| User.Id | Id. de Microsoft Planner del usuario. |
| User.ExternalId | Microsoft Entra ID del usuario. |
| User.DisplayName | El nombre para mostrar del usuario. |
| User.InternalDisplayName | El nombre para mostrar del usuario de Microsoft Planner. |
| User.UserPrincipalName | El nombre principal del usuario (UPN). |
| User.PrincipalType | El valor siempre es "User". |
| User.UserDetailsId | Identificador único del objeto de detalles del usuario. |
| User.ICalendarPublishEnabled | Si es True, el uso compartido de ICalendar está habilitado para el plan. Para obtener más información, vaya a Ver el calendario de Planner en Outlook. |
| User.OptedInNotifications | Las notificaciones por las que ha optado el usuario. |
| User.OptedOutNotifications | Las notificaciones que ha descartado el usuario. |
| User.FavoritePlans | El marcador de planes que el usuario ha marcado como favorito. |
| User.FavoritePlans.Id | Id. de Microsoft Planner del plan. |
| User.FavoritePlans.BookmarkName | El nombre asignado al marcador. |
| User.FavoritePlans.OrderHint | Se usa para el criterio de ordenación. Vea Usar las sugerencias de orden en Microsoft Planner. |
| User.RecentPlans | Los planes que el usuario ha abierto recientemente. |
| User.RecentPlans.Id | Id. de Microsoft Planner del plan. |
| User.RecentPlans.BookmarkName | El nombre asignado al marcador. |
| User.RecentPlans.LastAccess | La última vez que se ha abierto el plan. |
| User.UserData | Los datos personalizados del cliente web de Planner. |
| User.UserData.Key | La clave de datos personalizados. |
| User.UserData.Value | El valor de datos personalizados. |
| User.AssignedTaskOrdering | El criterio de ordenación de las tareas asignadas al usuario. |
| User.AssignedTaskOrdering.PlanId | Id. de Microsoft Planner del plan que contiene la tarea. |
| User.AssignedTaskOrdering.Id | Id. de Microsoft Planner de la tarea. |
| User.AssignedTaskOrdering.Order | Se usa para el criterio de ordenación. Vea Usar las sugerencias de orden en Microsoft Planner. |
| User.AssignedTaskOrdering.Title | El título de la tarea. |
Planear archivos
Se asignará a cada nombre de archivo de plan el prefijo "Plan" y el Id. de Microsoft Planner del plan. Cada archivo tendrá las siguientes propiedades:
| Propiedad | Descripción |
|---|---|
| Plan.Id | Id. de Microsoft Planner del plan. |
| Plan.Title | El título del plan. Nota: Los planes con el título RosterPlaceholderPlan_{89F9907E-D21D-4C90-A4B8-7A76CF3E6F70} indican que el archivo actual representa una lista que se ha creado, pero que aún no tiene un plan creado dentro de él. |
| Plan.Owner | El propietario del plan (una entidad de grupo o usuario). |
| Plan.Owner.Id | Id. de Microsoft Planner de la entidad (grupo o usuario). |
| Plan.Owner.ExternalId | Microsoft Entra ID de la entidad (grupo o usuario). |
| Plan.Owner.DisplayName | El nombre para mostrar del propietario (grupo o usuario). |
| Plan.Owner.UserPrincipalName | El nombre principal de usuario (UPN) si el propietario es un usuario. |
| Plan.Owner.PrincipalType | El tipo de entidad (grupo o usuario). |
| Plan.Container | Contenedor para el plan. |
| Plan.Container.ContainerType | Tipo de contenedor (grupo, lista). |
| Plan.Container.ExternalId | Microsoft Entra ID del grupo. |
| Plan.Container.Description | Nombre para mostrar del grupo. |
| Plan.CreatedDate | La fecha y hora en que se ha creado el archivo. |
| Plan.CreatedBy | El usuario que ha creado el plan. Para obtener más información, vea Propiedades de usuario. |
| Plan.ModifiedDate | La fecha y hora en que se ha actualizado el plan por última vez. |
| Plan.ModifiedBy | El nombre del usuario que ha actualizado el plan por última vez. Para obtener más información, vea Propiedades de usuario. |
| Plan.PlanDetailsId | El identificador único del objeto de detalles del plan. |
| Plan.ICalendarPublishEnabled | Si es True, el uso compartido de ICalendar está habilitado para el plan. Consulte las tareas en un calendario para obtener más información. |
| Plan.CreateTaskCommentWhen | Los eventos que harán que se cree un comentario para una tarea del plan. |
| Plan.ReferencesToPlan | Los sistemas externos que se vinculan al plan. Por ejemplo, si se inserta un plan de Microsoft Planner en el cliente de escritorio de Project Online. |
| Plan.ReferencesToPlan.ExternalId | Id. de sistema externo de este plan. |
| Plan.ReferencesToPlan.AssociationType | El tipo de vínculo al plan, especificado por la aplicación externa. |
| Plan.ReferencesToPlan.CreatedDate | La fecha y hora en que se ha creado el objeto de referencia. |
| Plan.ReferencesToPlan.CustomLinkText | Texto que puede usarse al mostrar la dirección URL. |
| Plan.ReferencesToPlan.DisplayAs | Especifica cómo deben presentarse los datos de referencia, como la dirección URL, en una experiencia de usuario. |
| Plan.ReferencesToPlan.IsCreationContext | Establecer en true si la referencia se estableció cuando se creó el plan. |
| Plan.ReferencesToPlan.OwnerAppId | Id. de la aplicación que ha creado la referencia. |
| Plan.ReferencesToPlan.DisplayNameSegments | La ruta de navegación de la ubicación en la que se describe lo que hace referencia a este plan. |
| Plan.ReferencesToPlan.Url | El vínculo directo a la aplicación que hace referencia al plan. |
| Plan.CategoryDescriptions | El conjunto completo de categorías del plan. |
| Plan.CategoryDescriptions.Index | El índice de la descripción de la categoría. |
| Plan.CategoryDescriptions.Description | El texto de la etiqueta del valor de índice de descripción de categoría correspondiente. |
| Plan.PlanFollowers | Si Plan.Container.ContainerType es Grupo, este campo son los usuarios que siguen el plan. Si Plan.Container.ContainerType es Lista de participantes, este campo son los usuarios que son miembros de la lista. |
| Plan.TimelineId | La característica está en desuso. |
| Plan.TimelineDisplaySettings | La característica está en desuso. |
| Plan.TimelineLockedWidth | La característica está en desuso. |
| Plan.Tasks | Los objetos de tareas del plan. |
| Plan.Tasks.Id | Identificador único de la tarea. |
| Plan.Tasks.Title | El nombre de la tarea. |
| Plan.Tasks.BucketId | El Id. de Microsoft Planner del depósito en el que se encuentra la tarea. |
| Plan.Tasks.BucketName | El nombre del depósito. |
| Plan.Tasks.PercentComplete | El estado de finalización de la tarea, de 0 a 100. |
| Plan.Tasks.StartDate | La fecha en la que se programa el comienzo de la tarea. |
| Plan.Tasks.DueDate | La fecha en la que está programada la finalización de la tarea. |
| Plan.Tasks.ConversationThreadId | Identificador único de conversación de Microsoft Exchange. |
| Plan.Tasks.PreviewType | La vista previa que se muestra en la tarjeta de tarea. |
| Plan.Tasks.OrderHint | Se usa para el criterio de ordenación. Vea Usar las sugerencias de orden en Microsoft Planner. |
| Plan.Tasks.CreatedBy | El usuario que ha creado la lista. Para obtener más información, vea Propiedades de usuario. |
| Plan.Tasks.CreatedDate | La fecha en la que se ha creado la tarea. |
| Plan.Tasks.CompletedBy | El usuario que ha finalizado la tarea. Para obtener más información, vea Propiedades de usuario. |
| Plan.Tasks.CompletedDate | La fecha en que se ha finalizado la tarea. |
| Plan.Tasks.ModifiedBy | El usuario que ha actualizado la tarea por última vez. Para obtener más información, vea Propiedades de usuario. |
| Plan.Tasks.ModifiedDate | La fecha de la última actualización de la tarea. |
| Plan.Tasks.AppliedCategories | Las etiquetas seleccionadas en el índice CategoryDescriptions del plan. |
| Plan.Tasks.Recurrence | Define la periodicidad activa o inactiva para la tarea. null cuando la periodicidad nunca se ha definido para la tarea. |
| Plan.Tasks.Recurrence.SeriesId | La serie de periodicidad a la que pertenece esta tarea. Valor basado en GUID que actúa como identificador único de una serie. |
| Plan.Tasks.Recurrence.OccurrenceIndex | Índice basado en 1 de esta tarea dentro de la serie de periodicidad. La primera tarea de una serie tiene el valor 1, la siguiente tarea de la serie tiene el valor 2, etc. |
| Plan.Tasks.Recurrence.PreviousInSeriesTaskId | Identificador de tarea de la tarea anterior de esta serie. null para la primera tarea de una serie, ya que no tiene ninguna predecesora. Cada tarea posterior de la serie tiene un valor correspondiente a su predecesor. |
| Plan.Tasks.Recurrence.NextInSeriesTaskId | Identificador de tarea de la siguiente tarea de esta serie. Este valor se asigna en el momento en que se crea la siguiente tarea de la serie y es null anterior a ese momento. |
| Plan.Tasks.Recurrence.RecurrenceStartDate | Fecha y hora en que comenzó esta serie de periodicidad. Para la primera tarea de una serie (OccurrenceIndex = 1), este valor corresponde a Schedule.Range.StartDate. Para las tareas posteriores de la serie (OccurrenceIndex>= 2) este valor se copia de la tarea anterior y nunca cambia; conserva la fecha de inicio de la serie periódica. |
| Plan.Tasks.Recurrence.Schedule | Programación de periodicidad. null indica que se ha cancelado la periodicidad. Tenga en cuenta que si se asigna NextInSeriesTaskId , este valor de programación se conservará como una instantánea del aspecto de la programación en el momento de la finalización de esta tarea. |
| Plan.Tasks.Recurrence.Schedule.Pattern | Patrón de periodicidad. El patrón, junto con Schedule.Range, se usan para calcular schedule.NextOccurrenceDate. |
| Plan.Tasks.Recurrence.Schedule.Pattern.IsDailyCadence | True para la cadencia diaria (en cuyo caso DaysOrDates está vacío). False de lo contrario (es decir, para la cadencia semanal, mensual o anual). |
| Plan.Tasks.Recurrence.Schedule.Pattern.Interval | Intervalo aplicado al tipo de cadencia. Los valores mayores que 1 significan que se omitirá un período. Ejemplos: para un patrón Diario, un intervalo de 2 significa que las tareas se repetirán cada dos días (o cada dos días). Para un patrón mensual, un intervalo de 3 significa que las tareas se repetirán cada tres meses (también conocidas como trimestrales). |
| Plan.Tasks.Recurrence.Schedule.Pattern.DaysOrDates | Cada entrada de esta colección representa la definición de exactamente un día o fecha. Ejemplo: "FixedYearly,August,15" significa el 15 de agosto del año. "FloatingMonthly,Second,Monday" significa el segundo lunes del mes. "Weekly,Wednesday","Weekly,Friday" significa semanalmente los miércoles y viernes. |
| Plan.Tasks.Recurrence.Schedule.Pattern.FirstDayOfWeek | El primer día de la semana (normalmente domingo); esto solo lo usan los patrones semanales y es null para patrones no semanales. |
| Plan.Tasks.Recurrence.Schedule.Range | Especifica cuándo se inicia y finaliza la periodicidad. |
| Plan.Tasks.Recurrence.Schedule.Range.StartDate | Fecha a partir de la cual debe comenzar Recurrence.Schedule . Los usuarios pueden actualizar este valor al realizar cambios en Recurrence.Schedule.Pattern. |
| Plan.Tasks.Recurrence.Schedule.Range.Kind | Actualmente, el único valor admitido es NoEnd, lo que indica que la serie no finalizará automáticamente. |
| Plan.Tasks.Recurrence.Schedule.NextOccurrenceDate | La fecha siguiente para esta Recurrence.Schedule. Cuando se crea una instancia de una nueva tarea para continuar con la serie de periodicidad, esta fecha se usa para el DueDate de la nueva tarea. |
| Plan.Tasks.TaskDetailsId | Identificador único del objeto de detalles de la tarea. |
| Plan.Tasks.Description | La descripción de la tarea. |
| Plan.Tasks.AssignedToTaskBoardFormatId | Identificador único del objeto que es el formato del panel de tareas. |
| Plan.Tasks.AssignedToTaskBoardFormatUnassignedOrderHint | Se usa para el criterio de ordenación. Vea Usar las sugerencias de orden en Microsoft Planner. |
| Plan.Tasks.AssignedToTaskBoardFormatOrderHintsByAssignee | Sugerencia para cada uno de los encargados. |
| Plan.Tasks.AssignedToTaskBoardFormatOrderHintsByAssignee.AssignedTo: | El usuario al que se asigna la tarea. Para obtener más información, vea Propiedades de usuario. |
| Plan.Tasks.AssignedToTaskBoardFormatOrderHintsByAssignee.Order | El orden de las tareas especificadas por encargado en la vista Asignada a. |
| Plan.Tasks.BucketTaskBoardFormatId | Identificador único del objeto que es el formato del panel de tareas de depósito. |
| Plan.Tasks.BucketTaskBoardFormatOrderHint | Se usa para el criterio de ordenación. Vea Usar las sugerencias de orden en Microsoft Planner. |
| Plan.Tasks.ProgressTaskBoardFormatId | Identificador único del objeto cuando se agrupa por progreso en lugar de en formato de depósito. |
| Plan.Tasks.ProgressTaskBoardFormatOrderHint | Se usa para el criterio de ordenación. Vea Usar las sugerencias de orden en Microsoft Planner. |
| Plan.Tasks.TimelineFormatId | La característica está en desuso. |
| Plan.Tasks.TimelineFormatShowOnTimeline | La característica está en desuso. |
| Plan.Tasks.TimelineFormatAnchorPosition | La característica está en desuso. |
| Plan.Tasks.TimelineFormatCalloutHeight | La característica está en desuso. |
| Plan.Tasks.TimelineFormatColor | La característica está en desuso. |
| Plan.Tasks.TimelineFormatDrawingStyle | La característica está en desuso. |
| Plan.Tasks.TimelineFormatLabelOffsetX | La característica está en desuso. |
| Plan.Tasks.TimelineFormatLabelOffsetY | La característica está en desuso. |
| Plan.Tasks.TimelineFormatSwimlane | La característica está en desuso. |
| Plan.Tasks.References | Los vínculos externos. |
| Plan.Tasks.References.Url | La URL del vínculo. |
| Plan.Tasks.References.Alias | La descripción del texto del vínculo. |
| Plan.Tasks.References.Type | El tipo de archivo al que se vincula. |
| Plan.Tasks.References.ModifiedBy | El usuario que ha actualizado el vínculo por última vez. Para obtener más información, vea Propiedades de usuario. |
| Plan.Tasks.References.ModifiedDate | La fecha de la última actualización del vínculo. |
| Plan.Tasks.References.PreviewPriority | Representa la prioridad de una referencia que se mostrará como una vista previa de la tarea en la interfaz de usuario. Microsoft Planner solo muestra el elemento de mayor prioridad. |
| Plan.Tasks.Assignments | Las asignaciones de tareas. |
| Plan.Tasks.Assignments.AssignedTo | El usuario al que está asignada la tarea. Para obtener más información, vea Propiedades de usuario. |
| Plan.Tasks.Assignments.AssignedBy | El usuario que ha asignado la tarea. Para obtener más información, vea Propiedades de usuario. |
| Plan.Tasks.Assignments.Order | El orden de las tareas si esta se asigna a varias entidades. |
| Plan.Tasks.Checklist | La lista de comprobación de la tarea. |
| Plan.Tasks.Checklist.Id | Identificador único de un elemento de lista de comprobación. |
| Plan.Tasks.Checklist.Title | El nombre del elemento de la lista de comprobación. |
| Plan.Tasks.Checklist.OrderHint | Se usa para el criterio de ordenación. Vea Usar las sugerencias de orden en Microsoft Planner. |
| Plan.Tasks.Checklist.IsChecked | Si es verdadero, el elemento de la lista de comprobación se ha completado. |
| Plan.Tasks.Checklist.ModifiedBy | El usuario que ha actualizado la lista de comprobación por última vez. Para obtener más información, vea Propiedades de usuario. |
| Plan.Tasks.Checklist.ModifiedDate | La fecha de la última actualización de la lista de comprobación. |
| Plan.Tasks.UserContentLastModifiedBy | El usuario que ha actualizado la tarea o los detalles de la tarea por última vez. Para obtener más información, vea Propiedades de usuario. |
| Plan.Tasks.UserContentLastModifiedDate | La fecha en que se ha actualizado por última vez la tarea o los detalles de la tarea. |
| Plan.Buckets | Los objetos de depósito del plan. |
| Plan.Buckets.Id | Identificador único del depósito. |
| Plan.Buckets.Title | El nombre del depósito. |
| Plan.Buckets.OrderHint | Se usa para el criterio de ordenación. Vea Usar las sugerencias de orden en Microsoft Planner. |
| Plan.Buckets.Createdby | El usuario que ha creado el depósito. Para obtener más información, vea Propiedades de usuario. |
| Plan.Buckets.CreatedDate | La fecha de creación del depósito. |
| Plan.Buckets.ModifiedBy | El usuario que ha actualizado el depósito por última vez. Para obtener más información, vea Propiedades de usuario. |
| Plan.Buckets.ModifiedDate | La fecha de la última actualización del depósito. |
Las propiedades de usuario en el archivo Plans.json
Hay muchos objetos en Plans.json datos que representan un usuario Microsoft Planner y tendrán propiedades similares. Entre estos objetos se incluyen:
- 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
Todas las opciones anteriores tendrán las propiedades siguientes:
| Propiedad | Descripción |
|---|---|
| Id. | Id. de Microsoft Planner del usuario. |
| ExternalId | Microsoft Entra ID del usuario. |
| DisplayName | El nombre para mostrar del usuario. |
| UserPrincipalName | El nombre principal del usuario (UPN). |
| PrincipalType | El tipo de entidad (usuario o grupo). |