Get-O365ClientOSDetailReport

  • 参考
模块:
ExchangePowerShell
适用于:
Exchange Online

此 cmdlet 仅在基于云的服务中可用。

该cmdlet已于2018年1月被废弃。 有关 Microsoft 365 中可用的替换 Microsoft Graph 报告的信息，请参阅 在 Microsoft Graph 中使用 Microsoft 365 的使用情况报告中的子主题。

使用 Get-O365ClientOSDetailReport cmdlet 可获取客户端操作系统使用情况的详细报告。

有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。

语法

Get-O365ClientOSDetailReport
   [-EndDate <DateTime>]
   [-OperatingSystem <String>]
   [-OperatingSystemVersion <String>]
   [-ResultSize <Unlimited>]
   [-StartDate <DateTime>]
   [-WindowsLiveID <String>]
   [<CommonParameters>]

说明

此报告介绍了所有活动用户的操作系统详细信息。 每个用户最多包含四个操作系统的数据每天聚合并保留 5 天。 下面的列表介绍了结果中返回的属性。

  • TenantGuid：租户的唯一标识符。
  • TenantName：租户名称。
  • 日期：操作系统和版本组合的连接时间戳。
  • WindowsLiveID：user@domain格式的用户 ID。
  • DisplayName：用户名。
  • LastAccessTime：用户使用此操作系统和版本组合连接的上次日期。
  • ObjectId：用户对象 ID。
  • OperatingSystem：操作系统名称。
  • 版本：操作系统版本。
  • OperatingSystemUsageCount：报告期间使用此操作系统和版本组合的天数

您必须先获得权限，然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。

示例

示例 1

Get-O365ClientOSDetailReport -WindowsLiveID john@contoso.com -StartDate 05/01/2017 -EndDate 05/03/2017

此示例检索用户 John 在 2017 年 5 月 1 日到 2017 年 5 月 3 日期间的操作系统详细信息。

示例 2

Get-O365ClientOSDetailReport -OperatingSystem Android

本示例检索当前 5 天保留期内 Android 操作系统的操作系统详细信息， (未) 指定开始日期和结束日期。

参数

-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

-OperatingSystem

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

-OperatingSystemVersion

OperatingSystemVersion 参数按操作系统版本筛选报表。 如果您不使用此参数，则报告中会包含所有操作系统版本。 此参数接受第一个次要版本号之前的版本号。 例如，使用 6 或 6.1，而不使用 6.1.9600。 不接受通配符。

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

-ResultSize

ResultSize 参数指定了要返回的结果的最大数量。 若要返回所有与查询相匹配的请求，则请将此参数的值设为无限制。 默认值为 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

-WindowsLiveID

WindowsLiveID 按用户 ID 筛选报告。

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