Exportación de datos de usuario de Microsoft Planner

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 incluidos en Planner y también datos incluidos en los planes de los que el usuario forma parte. 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

  1. 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 id. de Azure Active Directory o el UPN del usuario del que quiere exportar el contenido.
    ExportDirectory La ubicación para almacenar los archivos de salida. La carpeta ya debería existir.
    HostName Solo necesita usar este parámetro si tiene acceso a Planner mediante un nombre de host distinto de task.office.com. Por ejemplo, si tiene acceso a Planner a través de tasks.office365.us, incluya en el comando -HostName tasks. office365.us.

    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:\PlannerExportAdamBarr
    
  2. Se le solicitará que se autentique. Inicie sesión como administrador global, no como usuario que quiere exportar.

  3. 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 que le resulte más fácil 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 Id. de Azure Active Directory 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 Este valor es siempre "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

Cada nombre de archivo de plan tendrá el prefijo "Plan" y el identificador 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 todavía no tiene un plan creado en é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 Id. de Azure Active Directory 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 Id. de Azure Active Directory 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. Para obtener más información, vea Ver las tareas en un calendario.
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.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 una serie de objetos en Plans.json que representan un usuario de Microsoft Planner y tendrán propiedades similares. Estos objetos 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 Id. de Azure Active Directory del usuario.
DisplayName El nombre para mostrar del usuario.
UserPrincipalName El nombre principal del usuario (UPN).
PrincipalType El tipo de entidad (usuario o grupo).

Eliminación de datos de usuario de Microsoft Planner