Rapport de StaleMailboxDetail

Article
11/14/2016

L'URI REST StaleMailboxDetail fournit des informations détaillées sur les boîtes aux lettres dans une organisation Office 365 qui n'ont pas été accédées récemment. Utilisez ce rapport conjointement avec Rapport de StaleMailbox pour gérer les boîtes aux lettres inactives.

Dernière modification : jeudi 17 septembre 2015

S’applique à : Office 365

URI REST

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/StaleMailboxDetail[?ODATA options]

Champs

Vous pouvez spécifier les champs suivants dans les options de requête ODATA2 $select et $filter . Tous les champs sont renvoyés si aucune option $select n'est fournie. Les entrées sont toujours retournées dans l'ordre chronologique, avec la dernière entrée en cours les plus récents.

Ce rapport ne prend pas en charge l'option $orderby .

Nom	WCF Type *	Type EDM *	[In/Out] ** Description	Exemples de valeurs	Ajouté dans la version de service
Date	System.DateTime	Edm.DateTime	[In/Out] La date et l'heure de l'entrée du rapport. Voir la section « Remarques » pour plus d'informations sur l'utilisation de ce champ.	Date, abrégé (par exemple, 03/10/2013) ou l' Heure avec les guillemets (par exemple, "03/10/2013 4:55 PM")	2013-V1
DaysInactive	int	Edm.Int32	Le nombre de jours pendant lesquels les boîtes aux lettres a été inactif le jour indiqué dans le champ Date . Si l'utilisateur n'a jamais ouvert une session la boîte aux lettres, ce champ indique le nombre de jours dans la mesure où la boîte aux lettres a été créée.	25	2013-V1
LastLogin	System.DateTime	Edm.DateTime	Date et heure de que dernier accès à la boîte aux lettres. Si la boîte aux lettres n'a jamais été accédé, ce champ est explicitement null.	2012-09-27T16:44:57	2013-V1
TenantGuid	System.guid	Edm.Guid	[In/Out] Le GUID de l'organisation Office 365.	16a58f78-539f-47f7-b9bf-02a63867d73b	2013-V1
TenantName	string	Aucun n'est spécifié	[In/Out] Le nom de domaine de votre organisation.	example.onmicrosoft.com	2013-V1
UserName	string	Aucun n'est spécifié	[In/Out] Le nom complet associé à la boîte aux lettres.	UserOne	2013-V1
WindowsLiveID	string	Aucun n'est spécifié	[In/Out] Windows Live ID associé à la boîte aux lettres, dans le format d'adresse de messagerie SMTP.	userone@example.onmicrosoft.com	2013-V1

* Le Type de WCF fait référence au type de données .NET Framework affecté au champ lorsque vous créez un Windows Communication Foundation (WCF) une référence de Service dans Visual Studio. Le Type EDM fait référence aux types ADO.NET Entity Data Model (EDM) renvoyées dans les rapports au format Atom.

** Pour plus d'informations sur les indicateurs [In/Out], consultez la section « Paramètres d'entrée et les colonnes de sortie de rapport ».

Remarques

Chaque entrée dans le rapport comprend plusieurs champs de métadonnées. Pour plus d'informations, voir Les métadonnées renvoyées par le service web de création de rapports Office 365.

La période de rapport de contrôle

Avec la plupart des autres rapports, vous contrôler la période de rapports en utilisant les champs StartDate et EndDate . Ce rapport n'a pas ces champs et à la place utilise un champ unique Date pour spécifier le jour unique sur laquelle à un rapport détaillé sur la boîte aux lettres inactive. Si vous ne fournissez pas une option $filter avec le Date spécifié, le rapport par défaut sera fournissant des 90 derniers jours pour laquelle il existe plus d'informations, pour chaque boîte aux lettres inactive. Avec ces informations, vous pouvez analyser des tendances dans le nombre de boîtes aux lettres inactives.

Pour récupérer plus d'informations sur les boîtes aux lettres inactives actuellement, utilisez hier dans l'option $filter . Données sont différées quelque peu vers le magasin de données, et parce que le nombre de boîtes aux lettres obsolètes est connecté à la fin de la journée complète, il quasiment ne sera jamais données disponibles pour « aujourd'hui ». Par exemple, si nous sommes le 14 février, vous devriez normalement fournir l'option $filter comme suit.

...$filter=Date eq datetime'2013-02-13T00:00'

Pour demander les nombres pour chacun au cours des 14 derniers jours (en supposant qu'aujourd'hui est la 14 février 2013), utilisez la commande suivante.

...$filter=Date ge datetime'2013-02-01T00:00'

Le rapport StaleMailboxDetail prend en charge ainsi que l'option $top . Pour spécifier une période particulière, utilisez les deux options. L'exemple suivant retourne le que nombre de la boîte aux lettres obsolète qu'ils se sont produites lors de la première semaine de janvier 2013.

...$filter=Date ge datetime'2013-01-01T00:00'&$top=7

Exemples

La demande et réponse suivantes montrent comment récupérer les détails de boîtes aux lettres qui ont été inactifs le 1er janvier 2013, au format Atom XML. Sauts de ligne ont été ajoutés à la demande et la réponse pour plus de clarté.

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/StaleMailboxDetail?
  $select=Date,DaysInactive,LastLogin,UserName,WindowsLiveID&
  $filter=Date%20ge%20datetime'2013-01-01T00:00:00'&
  $top=1&$format=Atom

<?xml version="1.0" encoding="utf-8"?>
<feed xml:base="https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/" 
  xmlns="http://www.w3.org/2005/Atom" 
  xmlns:d="https://schemas.microsoft.com/ado/2007/08/dataservices" 
  xmlns:m="https://schemas.microsoft.com/ado/2007/08/dataservices/metadata">
  <id>https://reports.office365.com/ecp/reportingwebservice/reporting.svc/StaleMailboxDetail</id>
  <title type="text">StaleMailboxDetail</title>
  <updated>2013-02-10T03:40:33Z</updated>
  <link rel="self" title="StaleMailboxDetail" href="StaleMailboxDetail" />
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/StaleMailboxDetail(datetime'2013-01-11T00%3A00%3A00')</id>
    <category term="TenantReporting.StaleMailboxDetailReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="StaleMailboxDetailReport" href="StaleMailboxDetail(datetime'2013-01-11T00%3A00%3A00')" />
    <title />
    <updated>2013-02-10T03:40:33Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-01-11T00:00:00</d:Date>
        <d:WindowsLiveID>userone@example.onmicrosoft.com</d:WindowsLiveID>
        <d:UserName>UserOne</d:UserName>
        <d:LastLogin m:type="Edm.DateTime" m:null="true" />
        <d:DaysInactive m:type="Edm.Int32">115</d:DaysInactive>
      </m:properties>
    </content>
  </entry>
</feed>

L'exemple de code suivant montre les résultats de la même requête, au format JSON.

  {
    "d":
      [
          {
            "__metadata":
              {
                "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/StaleMailboxDetail(datetime'2013-01-11T00%3A00%3A00')",
                "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/StaleMailboxDetail(datetime'2013-01-11T00%3A00%3A00')",
                "type":"TenantReporting.StaleMailboxDetailReport"
              },
            "Date":"\/Date(1357862400000)\/",
            "WindowsLiveID":"userone@example.onmicrosoft.com",
            "UserName":"UserOne",
            "LastLogin":null,
            "DaysInactive":115
          }
      ]
  }

Paramètres d'entrée et de colonnes de sortie de l'état

Les indicateurs [In/Out] dans la table champs ont les significations suivantes :

Les champs marqués [In] dans les champs de table sont principalement destinés à être utilisés dans $filter=, $orderby=, et autres options de requête qui restreignent les entrées renvoie le rapport. Champs marqués [In] dans la table champs peuvent être inclus dans l'option $select= et ils s'affichent dans les entrées de rapport, mais ils ne contiendront aucune donnée utile.

Comme mentionné plus haut, ce rapport ne gère pas l'option $orderby .
Les champs marqués [In/Out] dans les champs de table peut être utilisée dans la sélection de colonne ($select=) et la restriction de l'entrée ($filter= options. Lorsque vous incluez un de ces champs dans l'option $select= , il apparaîtra dans les entrées de rapport et contient des données utiles lorsqu'elle est disponible.

Compatibilité

Le rapport StaleMailboxDetail a été introduit dans Service Office 365 version 2013-V1. Pour plus d'informations sur le contrôle de version, consultez la rubrique Contrôle de version dans le service web de création de rapports Office 365.

Applets de commande Windows PowerShell correspondant

Le rapport StaleMailboxDetail renvoie les mêmes informations que l'applet de commande Get-StaleMailboxDetailReportWindows PowerShell.

Autorisations

Le compte que vous utilisez pour accéder aux rapports doit avoir des autorisations d'administration dans l'organisation Office 365. Si le compte peut afficher ce rapport dans le Office 365 le panneau de configuration, puis le compte dispose des autorisations pour récupérer les données à partir du service web REST. Ce rapport oblige l'utilisateur à être affecté au rôle destinataires de l'affichage seul. Dans la structure des autorisations Office 365 par défaut, les utilisateurs disposant des autorisations d'administrateur suivantes peuvent accéder à ce rapport : administrateur, administrateur général, le mot de passe et administrateur de facturation, administrateur de service, administrateur de gestion des utilisateurs. Pour plus d'informations, voir Rapport d'utilisation de la boîte aux lettres :.

Disponibilité, persistance et la granularité des données

Collecte des informations disponibles par le biais de ce rapport une fois par jour.

Les informations de ce rapport sont disponibles pour une période d'un an, ou jusqu'à ce que l'abonnement est annulé.

Les événements peuvent être retardées par jusqu'à 24 heures avant qu'ils s'affichent dans un rapport.

Partager via