ConnectionbyClientType * 報告

發行項
11/14/2016

ConnectionbyClientType * REST Uri 提供摘要Office 365統計資料，Exchange Online 的連線會依據所用的用戶端應用程式種類。有四個報表，使用相同的整體結構和只能在他們掌控彙總資料的時間間隔之間的差異：每天、每週、每月及每年。為了簡化，四個報表詳細說明在一起。

前次修改時間: 2015年9月17日

適用於: Office 365

REST Uri

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/ConnectionbyClientTypeDaily[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/ConnectionbyClientTypeWeekly[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/ConnectionbyClientTypeMonthly[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/ConnectionbyClientTypeYearly[?ODATA options]

欄位

您可以指定下列欄位中$select、 $filter，以及$orderby ODATA2 查詢選項。如果沒有$select選項提供會傳回所有欄位。

名稱	WCF 類型 *	EDM 類型 *	[以/照] * * 描述	範例值	新增服務版本
Date	System.DateTime	Edm.DateTime	[納入/剔除]結束日期與時間的報表期間。如需時程表期間的詳細資訊，請參閱下列各節。	簡短日期(例如03/10/2013) 或使用引號 (例如"03/10/2013 4:55 PM") 的日期時間	2013-V1
ClientType	string	Edm.String	[納入/剔除]用來存取 Exchange Online 的用戶端應用程式的類型。	Lync 2013	2013-V1
Count	Long	Edm.Int64	[納入/剔除]用戶端類型所進行的報告時間週期期間的連線數目。	72	2013-V1
TenantGuid	System.guid	Edm.Guid	[納入/剔除]組織的 GUID。	16a58f78-539f-47f7-b9bf-02a63867d73b	2013-V1
TenantName	string	Edm.String	[納入/剔除]組織的主要網域名稱。	example.onmicrosoft.com	2013-V1

* WCF 類型參照Visual Studio中建立 Windows Communications Framework (WCF) 服務參考時指定給欄位的.NET Framework資料類型。EDM 類型參照傳回 Atom 格式化報告中的 ADO.NET 實體資料模型 (EDM) 類型。

* * [納入/剔除]：如需詳細資訊，請參閱在輸入參數並報告輸出欄] 區段中。

備註

在報表中的每個項目包含數個欄位的中繼資料。如需詳細資訊，請參閱一般 Office 365 報告 web 服務所傳回的中繼資料。

四個報表類型不同只能隨著每個報告項目涵蓋的時間。Date 功能變數中報告的時間代表期結束的時間。日期及時間報告中的 HTTPS 取得X-timezone標頭中指定的時區。如果未不指定任何時區，則會使用 UTC 時間。時間持續報告以下列方式計算。

報表名稱	時間週期計算
每日() ConnectionbyClientTypeDaily	報告每天午夜精準地啟動 (00:00:00) 結束之前在同一天的午夜 (23.59:59.9999...)。報告的最後一天會是一個完整天的資料可用且不會包含目前的日期。日期及時間Date ] 欄位中傳回代表該報表天結束。
每週() ConnectionbyClientTypeWeekly	報表週午夜精準地啟動 (00:00:00)、早期在星期六、結束之前在下列星期五晚上午夜 (23:59:59.9999...)。最近報告的項目是一個包含目前的日期和因此將通常擴充超過要求報表時。日期及時間Date ] 欄位中傳回代表該報告的週的結尾。
每月() ConnectionbyClientTypeMonthly	報表的月份午夜精準地啟動 (00:00:00) 上的第一天的月和結束之前在該月的最後一個行事曆天的午夜 (23.59:59.9999...)。最近報告的項目是一個包含目前的日期與因此通常可擴充超過要求報表時。日期及時間Date ] 欄位中傳回代表該報表的月份的結尾。
每年() ConnectionbyClientTypeYearly	報表年份午夜精準地啟動 (00:00:00) 年 1 月 1 日該行事曆年度和結束的之前在該相同的月曆年 12 月 31 午夜 (23.59:59.9999...)。最近報告的項目是一個包含目前的日期與因此通常可擴充超過要求報表時。日期及時間Date ] 欄位中傳回代表該報表的月份的結尾。

範例

下列的要求及回應配對示範如何擷取此報告會列出每個月的每個用戶端多少個連線，以 JSON 格式輸入。

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/ConnectionbyClientTypeMonthly?
    $select=Date,ClientType,Count&
    $format=Json

  {
    "d":
      {
        "results":
          [
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                        ConnectionbyClientTypeMonthly(datetime'2013-07-31T00%3A00%3A00')",
                    uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                        ConnectionbyClientTypeMonthly(datetime'2013-07-31T00%3A00%3A00')",
                    "type":"TenantReporting.ConnectionByClientTypeReport"
                  },
                "Date":"\/Date(1375228800000)\/",
                "ClientType":"MAPI",
                "Count":"0"
              },
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                        ConnectionbyClientTypeMonthly(datetime'2013-07-31T00%3A00%3A00')",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                        ConnectionbyClientTypeMonthly(datetime'2013-07-31T00%3A00%3A00')",
                    "type":"TenantReporting.ConnectionByClientTypeReport"
                  },
                "Date":"\/Date(1375228800000)\/",
                "ClientType":"POP3",
                "Count":"0"
              },
            
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                        ConnectionbyClientTypeMonthly(datetime'2013-07-31T00%3A00%3A00')",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                        ConnectionbyClientTypeMonthly(datetime'2013-07-31T00%3A00%3A00')",
                    "type":"TenantReporting.ConnectionByClientTypeReport"
                  },
                "Date":"\/Date(1375228800000)\/",
                "ClientType":"IMAP",
                "Count":"0"
              },
            
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                        ConnectionbyClientTypeMonthly(datetime'2013-07-31T00%3A00%3A00')",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                        ConnectionbyClientTypeMonthly(datetime'2013-07-31T00%3A00%3A00')",
                    "type":"TenantReporting.ConnectionByClientTypeReport"
                  },
                "Date":"\/Date(1375228800000)\/",
                "ClientType":"EAS",
                "Count":"0"
              },
            
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                        ConnectionbyClientTypeMonthly(datetime'2013-07-31T00%3A00%3A00')",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                        ConnectionbyClientTypeMonthly(datetime'2013-07-31T00%3A00%3A00')",
                    "type":"TenantReporting.ConnectionByClientTypeReport"
                  },
                "Date":"\/Date(1375228800000)\/",
                "ClientType":"OWA",
                "Count":"0"
              },
            
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                        ConnectionbyClientTypeMonthly(datetime'2013-07-31T00%3A00%3A00')",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/
                        ConnectionbyClientTypeMonthly(datetime'2013-07-31T00%3A00%3A00')",
                    "type":"TenantReporting.ConnectionByClientTypeReport"
                  },
                "Date":"\/Date(1375228800000)\/",
                "ClientType":"EWS",
                "Count":"0"
              }
          ]
      }
  }

輸入參數並報告輸出欄

在 [欄位] 表格中的 [納入/剔除] 指標具有下列含義：

欄位中表格主要用於$filter=、 $orderby=及其他查詢選項限制報表會傳回的項目中的欄位中標示為 [中]。在欄位標示為 [In 包含$select= ] 選項，可以是資料表欄位和其出現在報表項目但他們會包含任何的有用資料。
欄位標記 [納入/剔除] 欄選取範圍 ($select=) 和項目限制 ($filter=和$orderby=) 選項中可用資料表的欄位中。加入時這些欄位之一$select= ] 選項，將會出現在報表項目，且可用時將會包含有用的資料。

相容性

Office 365 service version 2013-V1中所引進的 ConnectionbyClientTypeDaily、 ConnectionbyClientTypeWeekly、 ConnectionbyClientTypeMontly 及 ConnectionbyClientTypeYearly 報告。如需版本設定的詳細資訊，請參閱在「 Office 365 報告」 web 服務的版本控制。

對應的 PowerShell cmdlet

ConnectionbyClientType * 報告傳回資訊與Get ConnectionByClientTypeReport Windows PowerShell指令程式相同。

權限

存取從報表的帳戶必須該Office 365組織中有系統管理權限。如果帳戶可以檢視這份報告Office 365控制台中的帳戶已從 REST web 服務擷取資料的權限。這份報告要求使用者指派給「僅檢視收件者」角色。在預設Office 365權限結構上使用下列的系統管理員權限的使用者可以存取此報告：帳務管理員、全域管理員、密碼管理員、服務管理員及使用者管理管理員。

資料精確度、保存及可用性

透過這些報告提供的資訊可分為單日期間從時區 HTTP X-timezone標頭中呼叫的應用程式所報告的午夜十二點開始。

針對此報表之資訊的一年以上，或取消訂閱直到一段。

事件可能最多它們顯示在報表中前 24 小時的延遲。

共用方式為

ConnectionbyClientType * 報告

REST Uri

欄位

備註

範例

輸入參數並報告輸出欄

相容性

對應的 PowerShell cmdlet

權限

資料精確度、保存及可用性

其他資源

共用方式為

ConnectionbyClientType * 報告

REST Uri

欄位

備註

範例

輸入參數並報告輸出欄

相容性

對應的 PowerShell cmdlet

權限

資料精確度、 保存及可用性

其他資源

資料精確度、保存及可用性