Get-O365ClientOSReport

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

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

使用 Get-O365ClientOSReport Cmdlet 取得用戶端作業系統使用的摘要報告。

如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法

Syntax

Get-O365ClientOSReport
   [-EndDate <DateTime>]
   [-OS <String>]
   [-ResultSize <Unlimited>]
   [-StartDate <DateTime>]
   [<CommonParameters>]

Description

此報告會顯示 OS 參數描述中名為 之五個最新作業系統版本的用戶端使用統計資料。 所有先前的作業系統版本都會合並成名為 Others 的第六個類別。 下列清單描述在結果中傳回的屬性。

  • TenantGuid:租使用者的唯一識別碼。
  • TenantName:租使用者名稱。
  • 日期:上次匯總明細專案資料的時間。
  • OperatingSystem:作業系統名稱。
  • 版本:作業系統版本。
  • OperatingSystemUsageCount:指定作業系統和版本組合在報告期間連線到服務的次數。

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

範例

範例 1

Get-O365ClientOSReport -OS Windows

本範例會取得 366 天資料保留期間的用戶端 Windows 使用摘要報告, (未指定開始和結束日期) 。

範例 2

Get-O365ClientOSReport -StartDate 06/13/2014 -EndDate 06/15/2014

此範例會擷取 2014 年 6 月 13 日到 2014 年 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

-OS

OS 參數會依作業系統篩選報表。 如果您未使用此參數,則會包含所有作業系統。 此參數接受的值為:

  • Windows
  • Android
  • iOS
  • 「Mac OS」
Type:String
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 參數會指定日期範圍的開始日期。

在您要執行命令的電腦上,使用該電腦的 [地區選項] 設定中定義的簡短日期格式。 例如,如果電腦設定成使用簡短日期格式 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