Get-VivaModuleFeatureEnablement
Este cmdlet está disponível somente no módulo do PowerShell do Exchange Online versão 3.2.0 ou posterior. Para obter mais informações, consulte Sobre o módulo do PowerShell do Exchange Online.
Use o cmdlet Get-VivaModuleFeatureEnablement para exibir se um recurso em um módulo do Viva está habilitado ou não para um usuário ou grupo específico. A habilitação ou não do recurso é chamada de "estado de habilitação" do recurso. O estado de habilitação retornado por esse cmdlet é baseado 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
Use o cmdlet Get-VivaModuleFeatureEnablement para exibir se um recurso em um módulo do Viva está habilitado ou não para um usuário ou grupo específico.
Você precisa usar o cmdlet Connect-ExchangeOnline para autenticar.
Este cmdlet requer o .NET Framework 4.7.2 ou posterior.
No momento, você precisa ser membro da função de Administradores Globais para executar esse cmdlet.
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-VivaModuleFeatureEnablement -ModuleId VivaInsights -FeatureId Reflection -Identity user@contoso.com
Este exemplo retorna o estado de habilitação do recurso Reflexão no Viva Insights para o user@contoso.com usuário.
Exemplo 2
Get-VivaModuleFeatureEnablement -ModuleId VivaInsights -FeatureId Reflection -Identity group@contoso.com
Este exemplo retorna o estado de habilitação do recurso Reflexão no Viva Insights para o group@contoso.com grupo.
Exemplo 3
Get-VivaModuleFeatureEnablement -ModuleId VivaInsights -FeatureId Reflection -Identity user@contoso.com -Detailed
Este exemplo retorna o estado de habilitação do recurso Reflexão no Viva Insights para o user@contoso.com usuário. A resposta foi aprimorada para fornecer informações adicionais sobre as políticas que estão orientando o estado de habilitação do recurso
Parâmetros
-Detailed
Aplicável: Exchange Online
Observação: este parâmetro está disponível na versão 3.8.1-Preview1 ou posterior do módulo.
O comutador detalhado aprimora a saída do comando, fornecendo informações mais abrangentes. Não é preciso especificar um valor com essa opção.
Esta opção retorna informações detalhadas, incluindo políticas relacionadas e 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 o recurso no módulo Viva.
Para exibir detalhes sobre os recursos em um módulo do Viva que dão suporte a controles de acesso a recursos, consulte o cmdlet Get-VivaModuleFeature. Os detalhes fornecidos pelo cmdlet Get-VivaModuleFeature incluem o identificador de recurso.
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 Identity especifica o nome UPN (UPN) do usuário ou o endereço SMTP (endereço de email) do grupo do qual você deseja exibir o status de habilitação do recurso.
Há suporte para grupos do Microsoft Entra habilitados para email.
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 |
-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 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.