StaleMailboxDetail-Bericht

Der REST-URI StaleMailboxDetail enthält ausführliche Informationen zu Postfächern in einer Organisation Office 365, die nicht vor kurzem zugegriffen wurde. Mithilfe dieses Berichts in Kombination mit StaleMailbox-Bericht Verwalten inaktiver Postfächer.

Letzte Änderung: Donnerstag, 17. September 2015

Gilt für: Office 365

REST-URIs

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

Felder

Sie können die folgenden Felder in den Optionen $select und $filter ODATA2 Abfrage angeben. Wenn keine Option $select bereitgestellt wird, werden alle Felder zurückgegeben. Einträge werden immer mit der letzte Eintrag wird das aktuellste Ergebnis in chronologischer Reihenfolge zurückgegeben.

In diesem Bericht unterstützt nicht die Option $orderby .

Name

WCF-Typ*

EDM-Typ*

[In/Out]** Beschreibung

Beispielwerte

Hinzugefügt in Dienstversion

Date

System.DateTime

Edm.DateTime

[In/Out] Datum und Uhrzeit des Berichts-Eintrags.

Finden Sie im Abschnitt "Hinweise" Informationen zur Verwendung dieses Feld ein.

Kurzes Datum (z. B. 03/10/2013) oder Datum und Uhrzeit mit Anführungszeichen (z. B. "03/10/2013 4:55 PM")

2013-V1

DaysInactive

int

Edm.Int32

Die Anzahl der Tage, die das Postfach auf den Tag im Feld Date angegebenen inaktiv war. Wenn der Benutzer nie mit dem Postfach angemeldet hat, gibt dieses Feld Anzahl von Tagen seit das Postfach erstellt wurde.

25

2013-V1

LastLogin

System.DateTime

Edm.DateTime

Das Datum und die Uhrzeit des letzten Zugriffs auf das Postfach. Wenn das Postfach nie zugegriffen wurde, wird dieses Feld explizit null sein.

2012-09-27T16:44:57

2013-V1

TenantGuid

System.guid

Edm.Guid

[In/Out] Die GUID der Organisation Office 365.

16a58f78-539f-47f7-b9bf-02a63867d73b

2013-V1

TenantName

string

Keine Angabe

[In/Out] Der Domänenname der Organisation.

example.onmicrosoft.com

2013-V1

UserName

string

Keine Angabe

[In/Out] Der Anzeigename dem Postfach zugeordnete.

UserOne

2013-V1

WindowsLiveID

string

Keine Angabe

[In/Out] Die Windows Live ID zugeordnete Postfach im Format von SMTP-e-Mail-Adresse.

userone@example.onmicrosoft.com

2013-V1

*Der WCF-Typ bezieht sich auf den .NET Framework-Datentyp, der dem Feld beim Erstellen eines Windows Communication Foundation (WCF)-Dienstverweises in Visual Studio zugewiesen wird. Der EDM-Typ bezieht sich auf die ADO.NET-EDM-Typen (Entity Data Model), die in Atom-formatierten Berichten zurückgegeben werden.

** Informationen zu den Indikatoren, die [In/Out] finden Sie im Abschnitt "Eingabe- und Ausgabeparameter Spalten".

Hinweise

Jeder Eintrag im Bericht enthält mehrere Metadatenfelder. Weitere Informationen finden Sie unter Gemeinsame Metadaten, die von der Office 365-Berichterstattungswebdienst zurückgegeben.

Steuern des Berichtszeitraums

Mit viele andere Berichte können Sie mithilfe von die Felder StartDate und EndDate des Berichtszeitraums Zeit steuern. In diesem Bericht verfügt nicht über die Felder an und verwendet stattdessen den einzelnen Tag auf dem Bericht Einzelheiten inaktives Postfach an einen einzelnen Date dar. Wenn Sie eine Option $filter mit nicht bereitstellen, die Date angegeben, der Bericht Standard wird zur Bereitstellung der vorherigen 90 Tage für die Informationen für jede inaktives Postfach vorhanden ist. Mit diesen Informationen können Sie Trends in die Anzahl der inaktiver Postfächer analysieren.

Verwenden Sie zum Abrufen von Informationen zu den derzeit inaktiver Postfächer dem gestrigen Datum in die Option $filter . Da Daten zu des Datamarts etwas verzögert ist, und die veraltete Mailbox Anzahlen am Ende des vollständigen Tag angemeldet sind, werden gibt es fast nie Daten verfügbar für "heute". Wenn heute 14. Februar ist, würden Sie die Option $filter wie im folgenden Beispiel angeben.

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

So fordern Sie die Anzahlen für jeden der letzten 14 Tage an (sofern noch heute ist 14 Februar 2013), verwenden Sie Folgendes.

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

Der Bericht StaleMailboxDetail unterstützt die $top -Option. Wenn Sie einen bestimmten Zeitraum angeben, verwenden Sie beide Optionen. Das folgende Beispiel gibt, dass veraltete Mailbox ermittelt, wie sie in der ersten Woche des Januar 2013 waren.

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

Beispiele

Die folgenden Anforderung und Antwort wird gezeigt, wie Details der Postfächer abzurufen, die am 1. Januar 2013 im Format Atom-XML-basierte inaktiv waren. Die Anforderung und die Antwort aus Gründen der Übersichtlichkeit wurden Zeilenumbrüche hinzugefügt.

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>

Das folgende Codebeispiel zeigt die Ergebnisse der gleichen Abfrage im JSON-Format.

  {
    "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
          }
      ]
  }

Eingabeparameter und Berichtsausgabespalten

Die [In/Out]-Indikatoren in der Feldertabelle haben folgende Bedeutung:

  • In der Feldertabelle mit [In] markierte Felder dienen in erster Linie für die Verwendung in $filter=, $orderby= und anderen Abfrageoptionen, die die im Bericht zurückgegebenen Einträge einschränken. In der Feldertabelle mit [In] markierte Felder können in die $select=-Option eingeschlossen werden und werden im Bericht angezeigt, enthalten jedoch keine nützlichen Daten.

    Wie bereits erwähnt, unterstützt diesen Bericht die Option $orderby nicht.

  • [In/Out] der Felder in den Feldern, die Tabelle kann, in die Spalte ($select=) und den Eintrag Einschränkung ($filter= -Optionen verwendet werden. Wenn Sie eines der Felder in der Option $select= einschließen, wird in die Berichtseinträge im angezeigt und enthält nützliche Daten aus, wenn es zur Verfügung steht.

Kompatibilität

Der Bericht StaleMailboxDetail wurde in Office 365-Dienstversion 2013-V1 eingeführt. Weitere Informationen zu versionsverwaltung finden Sie unter Versionsverwaltung in den Webdienst Office 365 Reporting.

Entsprechende Windows PowerShell-Cmdlets

Der Bericht StaleMailboxDetail gibt die gleiche Informationen wie das Cmdlet Get-StaleMailboxDetailReportWindows PowerShell zurück. 

Berechtigungen

Das Konto, mit dem Sie auf die Berichte zugreifen, muss über administrative Berechtigungen in der Office 365-Organisation verfügen. Wenn das Konto diesen Bericht in der Office 365-Systemsteuerung anzeigen kann, verfügt das Konto über Berechtigungen zum Abrufen der Daten aus dem REST-Webdienst. Für diesen Bericht muss der Benutzer der Rolle "Empfänger nur anzeigen" zugewiesen werden. In der standardmäßigen Office 365-Berechtigungsstruktur können Benutzer mit den folgenden Administratorberechtigungen auf diesen Bericht zugreifen: Rechnungsadministrator, globaler Administrator, Kennwortadministrator, Dienstadministrator und Benutzerverwaltungsadministrator. Weitere Informationen finden Sie unter Zusammenfassungsbericht zur Mailboxnutzung:.

Granularität, Dauerhaftigkeit und Verfügbarkeit von Daten

Informationen über die in diesem Bericht werden einmal pro Tag erfasst.

Die Informationen für diesen Bericht steht für einen Zeitraum von einem Jahr oder bis das Abonnement abgebrochen wird.

Ereignisse können bis zu 24 Stunden verzögert sein, bevor sie in einem Bericht angezeigt werden.