StaleMailboxDetail 報告
StaleMailboxDetail REST URI 提供無法存取已Office 365組織中信箱的詳細的資訊。管理非使用中的信箱與StaleMailbox 報告結合使用這份報告。
前次修改時間: 2015年9月17日
適用於: Office 365
REST Uri
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/StaleMailboxDetail[?ODATA options]
欄位
您可以指定下列欄位中$select和$filter ODATA2 查詢選項。如果沒有$select選項提供會傳回所有欄位。依時間順序與正在最新的最後一個項目一律傳回項目。
這份報告不支援 [ $orderby ] 選項。
名稱 |
WCF 類型 * |
EDM 類型 * |
[以/照] * * 描述 |
範例值 |
新增服務版本 |
---|---|---|---|---|---|
Date |
System.DateTime |
Edm.DateTime |
[納入/剔除]日期和時間報告項目。 請參閱 「 備註 」 小節使用此欄位的資訊。 |
簡短日期(例如03/10/2013) 或使用引號 (例如"03/10/2013 4:55 PM") 的日期時間 |
2013-V1 |
DaysInactive |
int |
Edm.Int32 |
在Date欄位中所述的天信箱已不在作用中的天數。如果使用者已永不登入信箱,此欄位會指出多少天後的信箱已建立。 |
25 |
2013-V1 |
LastLogin |
System.DateTime |
Edm.DateTime |
日期和時間上次存取信箱。如果從未已經存取信箱,此欄位會明確 null。 |
2012-09-27T16:44:57 |
2013-V1 |
TenantGuid |
System.guid |
Edm.Guid |
[納入/剔除]Office 365組織的 GUID。 |
16a58f78-539f-47f7-b9bf-02a63867d73b |
2013-V1 |
TenantName |
string |
None 指定 |
[納入/剔除]組織的網域名稱。 |
example.onmicrosoft.com |
2013-V1 |
UserName |
string |
None 指定 |
[納入/剔除]與信箱關聯的顯示名稱。 |
UserOne |
2013-V1 |
WindowsLiveID |
string |
None 指定 |
[納入/剔除]Windows Live ID 信箱、 SMTP 電子郵件地址格式相關聯。 |
userone@example.onmicrosoft.com |
2013-V1 |
* WCF 類型參照Visual Studio中建立Windows Communication Foundation (WCF)服務參考時指定給欄位的.NET Framework資料類型。EDM 類型參照傳回 Atom 格式化報告中的 ADO.NET 實體資料模型 (EDM) 類型。
* * 如 [納入/剔除] 指標的相關資訊,請參閱 「 輸入參數和報告輸出欄 」 一節。
備註
在報表中的每個項目包含數個欄位的中繼資料。如需詳細資訊請參閱一般 Office 365 報告 web 服務所傳回的中繼資料。
控制在報告期間
具有許多其他報告,您可以控制報表的時間期間使用StartDate和EndDate欄位。這份報告沒有這些欄位,而且而可指定非使用中信箱的相關的報告詳細資料所在的單一天會使用單一Date ] 欄位。如果您並不會提供與$filter選項Date指定,報表會使用預設提供的每一個非使用中信箱的資訊是先前 90 天。使用該資訊,您可以分析的非使用中的信箱數目的趨勢。
若要擷取目前停用信箱的相關的詳細資訊,請使用昨天的日期$filter ] 選項。由於資料有點延遲至資料超市,而且過時的信箱數量會記錄結尾處的完整天,幾乎絕不會有資料可用"今天"。例如,年 2 月 14 今天時,會提供$filter選項如下所示。
...$filter=Date eq datetime'2013-02-13T00:00'
過去 14 天的每個要求計數 (今天假設為 2013 年 2 月 14 日),使用下列項目。
...$filter=Date ge datetime'2013-02-01T00:00'
StaleMailboxDetail 報告支援$top ] 選項。若要指定在特定時間期間,使用這兩個選項。下列會傳回過時的信箱統計在 2013 年 1 月日的第一週期間所顯示的一樣。
...$filter=Date ge datetime'2013-01-01T00:00'&$top=7
範例
下列的要求及回應將示範如何擷取之信箱的已停用在 2013 年 1 月 1 日 Atom xml 格式的詳細資訊。要求和回應的明確新增分行符號。
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>
下列程式碼範例會顯示相同的查詢結果 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
}
]
}
輸入參數並報告輸出欄
在 [欄位] 表格中的 [納入/剔除] 指標具有下列含義:
表主要用於$filter=、 $orderby=、 欄位中的欄位標示為 [In 和其他查詢選項會限制報告傳回的項目。$select= ] 選項,可以包含 [欄位] 表格中標示為 [中] 的欄位和他們會出現在報表項目,但他們會包含任何的有用資料。
如前所述,這份報告不支援 [ $orderby ] 選項。
欄位可以中欄選取範圍 ($select=) 和項目限制 ($filter=選項使用資料表欄位中標示為 [納入/剔除]。加入時這些欄位之一$select= ] 選項,它將會出現在報表項目並可用時將會包含有用的資料。
相容性
Office 365 service version 2013-V1中已採用 StaleMailboxDetail 報表。如需有關版本設定的詳細資訊,請參閱在 「 Office 365 報告 」 web 服務的版本控制。
相對應的 Windows PowerShell cmdlet
StaleMailboxDetail 報表會傳回資訊與Get StaleMailboxDetailReport Windows PowerShell指令程式相同。
權限
您用來存取報告的帳戶必須在Office 365組織中有系統管理權限。如果帳戶可以Office 365 [控制台] 中檢視這份報告的帳戶已從 REST web 服務擷取資料的權限。這份報告要求使用者指派給 「 僅檢視收件者 」 角色。在預設Office 365權限結構上使用下列的系統管理員權限的使用者可以存取此報告: 帳務管理員、 全域管理員、 密碼管理員、 服務管理員及使用者管理管理員。如需詳細資訊,請參閱MailboxUsage 報告。
資料精確度、 保存及可用性
透過這份報告提供的資訊收集每天一次。
針對此報表之資訊的一年以上,或取消訂閱直到一段。
事件可能最多它們顯示在報表中前 24 小時的延遲。