Set-VivaInsightsSettings
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.
Observação: Este cmdlet está disponível somente na versão 2.0.5 ou posterior do módulo.
Use o cmdlet Set-VivaInsightsSettings para controlar o acesso do usuário aos recursos no Viva Insights. Somente usuários com caixas de correio provisionadas do Exchange Online podem acessar recursos no aplicativo Viva Insights no Teams.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Default)
Set-VivaInsightsSettings
-Identity <String>
-Enabled <Boolean>
-Feature <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
- Administrador do Teams
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-VivaInsightsSettings -Identity roy@contoso.onmicrosoft.com -Enabled $false -Feature headspace
Este exemplo desabilita o acesso a todos os recursos do Headspace no Microsoft Viva Insights no Microsoft Teams para o usuário especificado.
Parâmetros
-Enabled
Aplicável: Exchange Online
O parâmetro Enabled habilita ou desabilita o acesso a recursos específicos do Microsoft Viva Insights no Microsoft Teams para o usuário. Os valores válidos são:
- $true: os recursos especificados em Microsoft Viva Insights no Microsoft Teams são habilitados para o usuário.
- $false: os recursos especificados em Microsoft Viva Insights no Microsoft Teams estão desabilitados para o usuário.
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: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Feature
Aplicável: Exchange Online
O parâmetro Feature especifica o recurso do Microsoft Viva Insights no Microsoft Teams para o usuário. Os valores válidos são:
- Headspace: Representa todos os recursos do Headspace.
- MeetingEffectivenessSurvey: esse valor está disponível somente na versão 2.0.6-Preview2 do módulo como parte de uma visualização privada.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Valores aceitos: | headspace |
| 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 |
-Identity
Aplicável: Exchange Online
O parâmetro Identity especifica o usuário que você deseja modificar. Você identifica o usuário pelo nome UPN (por exemplo, roy@contoso.onmicrosoft.com).
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 |
-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.