Set-MyAnalyticsFeatureConfig

Este cmdlet está disponível somente no módulo do PowerShell do Exchange Online. Para obter mais informações, consulte Sobre o módulo do PowerShell do Exchange Online.

Use o cmdlet Set-MyAnalyticsFeatureConfig para configurar a disponibilidade e os recursos do MyAnalytics para o usuário especificado.

Observação: Este cmdlet substitui o cmdlet Set-UserAnalyticsConfig.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Sintaxe

Default (Default)

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

Description

Este cmdlet requer o .NET Framework 4.7.2 ou posterior.

Para executar este cmdlet, você precisa ser membro de um dos seguintes grupos de função de diretório na organização de destino:

  • Administrador Global
  • Administrador do Exchange
  • Insights do Administrador

Para saber mais sobre as permissões de função de administrador no Microsoft Entra ID, consulte IDs de modelo de função.

Importante

A Microsoft defende fortemente o princípio do privilégio mínimo. Atribuir às contas apenas as permissões mínimas necessárias para realizar suas tarefas ajuda a reduzir os riscos de segurança e fortalece a proteção geral da sua organização. O Administrador Global é uma função altamente privilegiada que normalmente você limita a cenários de emergência ou quando não é possível usar uma função diferente.

Exemplos

Exemplo 1

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

Este exemplo disponibiliza o MyAnalytics e todos os recursos para Vikram.

Exemplo 2

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

Este exemplo disponibiliza o MyAnalytics para Swathy, mas desativa o recurso de resumo de email.

Exemplo 3

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

Este exemplo desabilita o recurso de email de resumo para Akshath.

Parâmetros

-Feature

Aplicável: Exchange Online

O parâmetro Feature especifica os recursos do MyAnalytics a serem habilitados ou desabilitados para o usuário. Os valores válidos são:

  • all (este é o valor padrão)
  • suplemento
  • dashboard
  • Digest-Email

Para realmente habilitar ou desabilitar um recurso especificado por esse parâmetro, use o parâmetro IsEnabled no mesmo comando.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Valores aceitos:dashboard, add-in, digest-email, all
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Identity

Aplicável: Exchange Online

O parâmetro Identity especifica o usuário que você deseja exibir. Você identifica o usuário pelo endereço de email.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-IsEnabled

Aplicável: Exchange Online

O parâmetro IsEnabled especifica se o recurso especificado pelo parâmetro Feature deve ser habilitado. Os valores válidos são:

  • $true: o recurso especificado está habilitado.
  • $false: o recurso especificado está desabilitado.

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PrivacyMode

Aplicável: Exchange Online

O parâmetro PrivacyMode especifica se o MyAnalytics deve ser habilitado ou desabilitado para o usuário especificado. Os valores válidos são:

-opt-in: O MyAnalytics está habilitado para o usuário. Use os parâmetros Feature e IsEnabled para habilitar ou desabilitar recursos específicos do MyAnalytics. -opt-out: O MyAnalytics está desabilitado para o usuário.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Valores aceitos:opt-in, opt-out
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ResultSize

Aplicável: Exchange Online

Esse parâmetro está reservado para uso interno da Microsoft.

Propriedades do parâmetro

Tipo:Unlimited
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.