Get-CsActiveUserReport

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

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

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

使用 Get-CsActiveUserReport cmdlet 查看有关基于云的组织中Skype for Business Online 用户的统计信息。 该 cmdlet 显示在指定时间段内登录并至少参加了一个对等会话或会议的唯一用户总数。

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

语法

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

说明

可以使用Get-CsActiveUserReport查询有关过去 3 个月内Skype for Business Online 用户的活动的信息。 在所指定的报表周期里，该 cmdlet 返回以下信息：

  • ActiveUsers
  • ActiveIMUsers
  • ActiveAudioUsers
  • ActiveVideoUsers
  • ActiveApplicationSharingUsers
  • ActiveFileTransferUsers
  • ActivePSTNConferencingUsers

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

示例

示例 1

Get-CsActiveUserReport -ReportType Monthly -StartDate 04/01/2015 -EndDate 04/30/2015

此示例显示有关 2015 年 4 月Skype for Business Online 用户的信息

参数

-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 参数按所指定的值汇总报表中的数据。 该参数的有效值为每日、每周、每月及每年。 使用 ReportType 的值与恰当的 StartDate 及 EndDate 参数的适当值来检查特定时间段的数据。

Type:ReportType
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

输入

Input types

若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。