Get-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 Get-VivaInsightsSettings para marcar se um usuário tem acesso aos recursos do Microsoft Viva Insights no Microsoft Teams. 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)
Get-VivaInsightsSettings
-Identity <String>
[-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
Get-VivaInsightsSettings -Identity roy@contoso.onmicrosoft.com
UserId : roy@contoso.onmicrosoft.com
IsInsightsHeadspaceEnabled : True
Este exemplo mostra a configuração do Microsoft Viva Insights no Microsoft Teams para o usuárioroy@contoso.onmicrosoft.com. A saída do comando mostra que os recursos do Headspace estão disponíveis para Roy.
Parâmetros
-Feature
Aplicável: Exchange Online
O parâmetro Recurso filtra os resultados pelo recurso especificado do Microsoft Viva Insights. 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 |
| 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 nome UPN (por exemplo, roy@contoso.onmicrosoft.com).
Cuidado: O valor $null ou um valor inexistente para o parâmetro Identity retorna todos os objetos como se você tivesse executado o comando Get- sem o parâmetro Identity. Verifique se todas as listas de valores para o parâmetro Identity são precisas e não contêm valores de $null inexistentes.
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.