Get-ConnectionByClientTypeReport

參考

模組:: ExchangePowerShell

適用於:: Exchange Online

此指令程式只能在雲端式服務中使用。

此指令程式已於2018年1月遭取代。如需 Microsoft 365 中可用替代 Microsoft Graph 報表的詳細資訊，請參閱在 Microsoft Graph 中使用 Microsoft 365 使用情況報表的副主題。

使用 Get-ConnectionByClientTypeReport Cmdlet 來檢視連線到組織中所有信箱之不同類型的用戶端摘要。用戶端類型表示不同的通訊協定，例如Outlook 網頁版、MAPI、POP3、IMAP4、Exchange ActiveSync和 Exchange Web 服務。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

Syntax

Get-ConnectionByClientTypeReport
   [-EndDate <DateTime>]
   [-ReportType <ReportType>]
   [-ResultSize <Unlimited>]
   [-StartDate <DateTime>]
   [<CommonParameters>]

Description

注意：此 Cmdlet 傳回的用戶端連線資訊有 7 天的延遲。例如，如果您在 2018 年 6 月 18 日執行 Cmdlet，就無法擷取在 2018 年 6 月 13 日到 2018 年 6 月 15 日之間對信箱建立連線的相關資訊。若要取得該日期範圍的連線資訊，您必須在 2018 年 6 月 22 日或更新版本上執行 Cmdlet。

您必須已獲指派權限，才能執行此指令程式。雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。

範例

範例 1

Get-ConnectionByClientTypeReport -StartDate 06/13/2015 -EndDate 06/15/2015

此範例會擷取用來連線到 2015 年 6 月 13 日到 2015 年 6 月 15 日之間所有信箱之不同類型的用戶端摘要。

參數

-EndDate

EndDate 參數會指定日期範圍的結束日期。

在您要執行命令的電腦上，使用該電腦的 [地區選項] 設定中定義的簡短日期格式。例如，如果電腦設定成使用簡短日期格式 mm/dd/yyyy，請輸入 09/01/2018 以指定 2018 年 9 月 1 日。您可以只輸入日期，或者也可以輸入日期和時間。如果輸入日期和時間，請使用引號 (") 括住值，例如 "09/01/2018 5:00 PM"。

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-ReportType

ReportType 參數會根據您指定的值，彙總報告中的資料。此參數的有效值為 Daily、Weekly、Monthly 和 Yearly。搭配使用 StartDate 和 EndDate 參數的適當值與 ReportType 的值，以在特定時間檢閱資料。

Type:	ReportType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-ResultSize

ResultSize 參數會指定傳回的結果筆數上限。若要傳回符合查詢的所有要求，請使用 unlimited 作為此參數的值。預設值為 1000。

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-StartDate

StartDate 參數會指定日期範圍的開始日期。

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

輸入

Input types

若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。

輸出

Output types

若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。