Get-VivaModuleFeatureEnablement
Este cmdlet só está disponível no módulo Exchange Online PowerShell versão 3.2.0 ou posterior. Para obter mais informações, veja Acerca do módulo Exchange Online PowerShell.
Utilize o cmdlet Get-VivaModuleFeatureEnablement para ver se uma funcionalidade num módulo Viva está ativada para um utilizador ou grupo específico. Se a funcionalidade está ou não ativada é referida como o "estado de ativação" da funcionalidade. O estado de ativação devolvido por este cmdlet baseia-se nas políticas de acesso definidas pelo administrador.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Default)
Get-VivaModuleFeatureEnablement
-FeatureId <String>
-Identity <String>
-ModuleId <String>
[-Detailed]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Description
Utilize o cmdlet Get-VivaModuleFeatureEnablement para ver se uma funcionalidade num módulo Viva está ativada para um utilizador ou grupo específico.
Tem de utilizar o cmdlet Connect-ExchangeOnline para autenticar.
Este cmdlet requer o .NET Framework 4.7.2 ou posterior.
Atualmente, tem de ser membro da função Administradores Globais para executar este cmdlet.
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-VivaModuleFeatureEnablement -ModuleId VivaInsights -FeatureId Reflection -Identity user@contoso.com
Este exemplo devolve o estado de ativação da funcionalidade Reflexão nas Informações Viva para o user@contoso.com utilizador.
Exemplo 2
Get-VivaModuleFeatureEnablement -ModuleId VivaInsights -FeatureId Reflection -Identity group@contoso.com
Este exemplo devolve o estado de ativação da funcionalidade Reflexão nas Informações Viva do group@contoso.com grupo.
Exemplo 3
Get-VivaModuleFeatureEnablement -ModuleId VivaInsights -FeatureId Reflection -Identity user@contoso.com -Detailed
Este exemplo devolve o estado de ativação da funcionalidade Reflexão nas Informações Viva para o user@contoso.com utilizador. A resposta é melhorada para fornecer informações adicionais sobre as políticas que estão a impulsionar o estado de ativação da funcionalidade
Parâmetros
-Detailed
Aplicável: Exchange Online
Nota: este parâmetro está disponível na versão 3.8.1-Preview1 ou posterior do módulo.
O comutador Detalhado melhora a saída do comando ao fornecer informações mais abrangentes. Não é preciso especificar um valor com essa opção.
Este comutador devolve informações detalhadas, incluindo políticas relacionadas e a sua eficácia.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| 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 |
-FeatureId
Aplicável: Exchange Online
O parâmetro FeatureId especifica a funcionalidade no módulo Viva.
Para ver detalhes sobre as funcionalidades num módulo Viva que suportam controlos de acesso a funcionalidades, consulte o cmdlet Get-VivaModuleFeature. Os detalhes fornecidos pelo cmdlet Get-VivaModuleFeature incluem o identificador da funcionalidade.
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 |
-Identity
Aplicável: Exchange Online
O parâmetro Identidade especifica o nome principal de utilizador (UPN) do utilizador ou o endereço SMTP (endereço de e-mail) do grupo do qual pretende ver o status de ativação de funcionalidades.
Os grupos de Microsoft Entra com capacidade de correio são suportados.
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 |
-ModuleId
Aplicável: Exchange Online
O parâmetro ModuleId especifica o módulo Viva.
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.