Set-MyAnalyticsFeatureConfig

此 cmdlet 仅在 Exchange Online PowerShell 模块中可用。 有关详细信息,请参阅关于 Exchange Online PowerShell 模块

使用 Set-MyAnalyticsFeatureConfig cmdlet 为指定用户配置 MyAnalytics 的可用性和功能。

注意:此 cmdlet 将替换 Set-UserAnalyticsConfig cmdlet。

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

语法

Default (默认值)

Set-MyAnalyticsFeatureConfig
    -Identity <String>
    [-Feature <String>]
    [-IsEnabled <Boolean>]
    [-PrivacyMode <String>]
    [-ResultSize <Unlimited>]
    [<CommonParameters>]

说明

此 cmdlet 需要 .NET Framework 4.7.2 或更高版本。

若要运行此 cmdlet,需要是目标组织中以下目录角色组之一的成员:

  • 全局管理员
  • Exchange 管理员
  • Insights 管理员

若要详细了解 Microsoft Entra ID 中的管理员角色权限,请参阅角色模板 ID

重要

Microsoft 建议使用权限最少的角色。 使用权限较低的帐户有助于提高组织的安全性。 全局管理员是一个权限很高的角色,应仅限于在无法使用现有角色的紧急情况下使用。

示例

示例 1

Set-MyAnalyticsFeatureConfig -Identity vikram@contoso.com -PrivacyMode opt-in

此示例使 MyAnalytics 和所有功能都可供 Vikram 使用。

示例 2

Set-MyAnalyticsFeatureConfig -Identity swathy@contoso.com -PrivacyMode opt-in -Feature digest-email -IsEnabled $false

此示例使 MyAnalytics 可用于 Swathy,但禁用摘要电子邮件功能。

示例 3

Set-MyAnalyticsFeatureConfig -Identity akshath@contoso.com -Feature digest-email -IsEnabled $false

此示例禁用 Akshath 的摘要电子邮件功能。

参数

-Feature

适用:Exchange Online

Feature 参数指定要为用户启用或禁用的 MyAnalytics 功能。 有效值包含:

  • 所有 (这是默认值)
  • 加载项
  • 仪表板
  • digest-email

若要实际启用或禁用此参数指定的功能,请在同一命令中使用 IsEnabled 参数。

参数属性

类型:String
默认值:None
接受的值:dashboard, add-in, digest-email, all
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Identity

适用:Exchange Online

Identity 参数指定要查看的用户。 你通过用户的电子邮件地址标识用户。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-IsEnabled

适用:Exchange Online

IsEnabled 参数指定是启用或禁用由 Feature 参数指定的功能。 有效值包含:

  • $true:启用指定的功能。
  • $false:禁用指定的功能。

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-PrivacyMode

适用:Exchange Online

PrivacyMode 参数指定为指定用户启用或禁用 MyAnalytics。 有效值包含:

-opt-in:已为用户启用 MyAnalytics。 使用 Feature 和 IsEnabled 参数启用或禁用特定的 MyAnalytics 功能。 -opt-out:对用户禁用 MyAnalytics。

参数属性

类型:String
默认值:None
接受的值:opt-in, opt-out
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ResultSize

适用:Exchange Online

保留此参数以供 Microsoft 内部使用。

参数属性

类型:Unlimited
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters