Partager via


Rapport de StaleMailbox

L'URI REST StaleMailbox fournit des boîtes aux lettres organisation qui n'ont pas été accédées récemment résumé des statistiques sur le nombre de Office 365. Utilisez ce rapport conjointement avec Rapport de StaleMailboxDetail 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/StaleMailbox[?ODATA options]

Champs

Les champs suivants peuvent être spécifiés dans les options de requête de 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 étant pour le jour le plus récent.

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

ActiveMailboxes

long

Edm.Int64

[In/Out] Le nombre de boîtes aux lettres actives au moment de l'état de Office 365.

265

2013-V1

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

InactiveMailboxes31To60Days

long

Edm.Int64

[In/Out] Le nombre de boîtes aux lettres de Office 365 qui n'ont pas été accédées dans les dernières 31 à 60 jours.

234

2013-V1

InactiveMailboxes61To90Days

long

Edm.Int64

[In/Out] Le nombre de boîtes aux lettres de Office 365 qui n'ont pas été accédées dans les dernières 61 à 90 jours.

22

2013-V1

InactiveMailboxes91To1460Days

long

Edm.Int64

[In/Out] Le nombre de boîtes aux lettres de Office 365 qui n'ont pas été consultés au cours de 91 à 1460 derniers jours (4 ans).

4

2013-V1

TenantGuid

System.guid

Edm.Guid

[In/Out] Le GUID de l'organisation.

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

* 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 ».

Notes

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 permettant de signaler le nombre de boîtes aux lettres ont été inactifs. 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 lesquels il existe des informations. Avec ces informations, vous pouvez analyser des tendances dans le nombre de boîtes aux lettres inactives.

Pour récupérer le nombre actuel de boîtes aux lettres inactives, utilisez hier dans l'option $filter . Données sont différées quelque peu dans le magasin de données, et parce que le nombre de boîtes aux lettres obsolètes est consigné lors de la journée complète est passée, 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 StaleMailbox 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 le nombre total de boîtes aux lettres obsolètes qui existait au cours des trois premiers jours de janvier 2013. Sauts de ligne ont été ajoutés à la demande et de réponse pour plus de clarté.

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/StaleMailbox?
  $select=Date,InactiveMailboxes31To60Days,InactiveMailboxes61To90Days,InactiveMailboxes91To1460Days&
  $filter=Date%20ge%20datetime'2013-01-01T00:00:00'&
  $top=7&
  $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/StaleMailbox</id>
  <title type="text">StaleMailbox</title>
  <updated>2013-02-10T02:55:21Z</updated>
  <link rel="self" title="StaleMailbox" href="StaleMailbox" />
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/StaleMailbox(datetime'2013-01-01T00%3A00%3A00')</id>
    <category term="TenantReporting.StaleMailboxReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="StaleMailboxReport" href="StaleMailbox(datetime'2013-01-01T00%3A00%3A00')" />
    <title />
    <updated>2013-02-10T02:55:21Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-01-01T00:00:00</d:Date>
        <d:InactiveMailboxes31To60Days m:type="Edm.Int64">0</d:InactiveMailboxes31To60Days>
        <d:InactiveMailboxes61To90Days m:type="Edm.Int64">0</d:InactiveMailboxes61To90Days>
        <d:InactiveMailboxes91To1460Days m:type="Edm.Int64">2</d:InactiveMailboxes91To1460Days>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/StaleMailbox(datetime'2013-01-02T00%3A00%3A00')</id>
    <category term="TenantReporting.StaleMailboxReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="StaleMailboxReport" href="StaleMailbox(datetime'2013-01-02T00%3A00%3A00')" />
    <title />
    <updated>2013-02-10T02:55:21Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-01-02T00:00:00</d:Date>
        <d:InactiveMailboxes31To60Days m:type="Edm.Int64">0</d:InactiveMailboxes31To60Days>
        <d:InactiveMailboxes61To90Days m:type="Edm.Int64">0</d:InactiveMailboxes61To90Days>
        <d:InactiveMailboxes91To1460Days m:type="Edm.Int64">2</d:InactiveMailboxes91To1460Days>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/StaleMailbox(datetime'2013-01-03T00%3A00%3A00')</id>
    <category term="TenantReporting.StaleMailboxReport" 
      scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="StaleMailboxReport" href="StaleMailbox(datetime'2013-01-03T00%3A00%3A00')" />
    <title />
    <updated>2013-02-10T02:55:21Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-01-03T00:00:00</d:Date>
        <d:InactiveMailboxes31To60Days m:type="Edm.Int64">0</d:InactiveMailboxes31To60Days>
        <d:InactiveMailboxes61To90Days m:type="Edm.Int64">0</d:InactiveMailboxes61To90Days>
        <d:InactiveMailboxes91To1460Days m:type="Edm.Int64">2</d:InactiveMailboxes91To1460Days>
      </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/StaleMailbox(datetime'2013-01-01T00%3A00%3A00')",
                "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/StaleMailbox(datetime'2013-01-01T00%3A00%3A00')",
                "type":"TenantReporting.StaleMailboxReport"
              },
            "Date":"\/Date(1356998400000)\/",
            "InactiveMailboxes31To60Days":"0",
            "InactiveMailboxes61To90Days":"0",
            "InactiveMailboxes91To1460Days":"2"
          },
          {
            "__metadata":
              {
                "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/StaleMailbox(datetime'2013-01-02T00%3A00%3A00')",
                "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/StaleMailbox(datetime'2013-01-02T00%3A00%3A00')",
                "type":"TenantReporting.StaleMailboxReport"
              },
            "Date":"\/Date(1357084800000)\/",
            "InactiveMailboxes31To60Days":"0",
            "InactiveMailboxes61To90Days":"0",
            "InactiveMailboxes91To1460Days":"2"
          },
          {
            "__metadata":
              {
                "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/StaleMailbox(datetime'2013-01-03T00%3A00%3A00')",
                "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/StaleMailbox(datetime'2013-01-03T00%3A00%3A00')",
                "type":"TenantReporting.StaleMailboxReport"
              },
            "Date":"\/Date(1357171200000)\/",
            "InactiveMailboxes31To60Days":"0",
            "InactiveMailboxes61To90Days":"0",
            "InactiveMailboxes91To1460Days":"2"
          }
      ]
  }

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.

  • Les champs marqués [In/Out] dans les champs de table peut être utilisée dans la sélection de la colonne ($select=) et les options de restriction ($filter=) d'entrée. 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.

    Comme mentionné plus haut, ce rapport ne gère pas l'option $orderby .

Compatibilité

Le rapport StaleMailbox 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 StaleMailbox renvoie les mêmes informations que l'applet de commande Get-StaleMailboxReportWindows 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.