Get-VivaInsightsSettings

Módulo:

Exchange PowerShell

Este cmdlet só está disponível no módulo Exchange Online PowerShell. Para obter mais informações, veja Acerca do módulo Exchange Online PowerShell.

Nota: este cmdlet só está disponível na versão 2.0.5 ou posterior do módulo.

Utilize o cmdlet Get-VivaInsightsSettings para marcar se um utilizador tem acesso a funcionalidades no Microsoft Viva Insights no Microsoft Teams. Apenas os utilizadores com Exchange Online caixas de correio aprovisionadas podem aceder às funcionalidades na aplicação 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, tem de ser membro de um dos seguintes grupos de funções 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, veja IDs de modelo de função.

Importante

A Microsoft defende fortemente o princípio do menor privilégio. Atribuir apenas as permissões mínimas necessárias para realizar as respetivas tarefas ajuda a reduzir os riscos de segurança e reforça a proteção geral da sua organização. O Administrador Global é uma função altamente privilegiada que normalmente limita a cenários de emergência ou quando não pode utilizar 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 de Microsoft Viva Insights no Microsoft Teams para o utilizador roy@contoso.onmicrosoft.com. O resultado do comando mostra que as funcionalidades do Headspace estão disponíveis para Roy.

Parâmetros

-Feature

Aplicável: Exchange Online

O parâmetro Feature filtra os resultados pela funcionalidade de Microsoft Viva Insights especificada. Os valores válidos são:

• Headspace: representa todas as funcionalidades do Headspace.
• MeetingEffectivenessSurvey: este valor só está disponível na versão 2.0.6-Preview2 do módulo como parte de uma Pré-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 Identidade especifica o utilizador que pretende ver. Identifica o utilizador pelo respetivo Nome Principal de Utilizador (UPN) (por exemplo, roy@contoso.onmicrosoft.com).

Atenção: o valor $null ou um valor inexistente para o parâmetro Identidade devolve todos os objetos como se tivesse executado o comando Get- sem o parâmetro Identity. Verifique se as listas de valores do parâmetro Identity estão corretas 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 suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.