Get-VivaModuleFeaturePolicy
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-VivaModuleFeaturePolicy para exibir as políticas de acesso para um recurso especificado em um módulo do Viva no Viva. As políticas são usadas para restringir ou conceder acesso ao recurso especificado para usuários específicos, grupos ou todo o locatário. Esse cmdlet fornece detalhes sobre as políticas, incluindo o identificador da política, o nome e a data de criação. O cmdlet pode filtrar políticas com base em MemberIds, permitindo que os administradores exibam políticas específicas para determinados usuários ou grupos.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
FeaturePolicy
Get-VivaModuleFeaturePolicy
[[-PolicyId] <String>]
-FeatureId <String>
-ModuleId <String>
[-ResultSize <Unlimited>]
[<CommonParameters>]
FeaturePolicyWithMembers
Get-VivaModuleFeaturePolicy
[[-FeatureId] <String>]
[[-MemberIds] <String[]>]
-ModuleId <String>
[-ResultSize <Unlimited>]
[<CommonParameters>]
Description
Use o cmdlet Get-VivaModuleFeaturePolicy para exibir as políticas de acesso para um recurso especificado em um módulo do Viva no Viva.
Você pode exibir todas as políticas de um recurso especificado em um módulo do Viva no Viva. Para exibir uma política específica, você pode incluir o parâmetro PolicyId.
O cmdlet pode filtrar políticas com base em MemberIds, permitindo que os administradores exibam políticas específicas para determinados usuários ou grupos.
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 ou das funções que foram atribuídas no nível do recurso para executar esse cmdlet.
Para saber mais sobre as funções atribuídas no nível do recurso, consulte Recursos disponíveis para gerenciamento de acesso a recursos.
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-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection
Este exemplo retorna detalhes sobre todas as políticas adicionadas para o recurso Reflexão no Viva Insights.
Exemplo 2
Get-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b
Este exemplo retorna detalhes sobre uma política específica adicionada para o recurso Reflexão no Viva Insights.
Exemplo 3
Get-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -MemberIds user1@contoso.com
Este exemplo retorna detalhes sobre as políticas do recurso Reflexão no Viva Insights que se aplicam ao usuário com o email user1@contoso.com.
Exemplo 4
Get-VivaModuleFeaturePolicy -ModuleId * -FeatureId * -MemberIds user1@contoso.com,group1@contoso.com
Este exemplo retorna detalhes sobre as políticas de todos os recursos em todos os módulos do Viva que se aplicam ao usuário com o email user1@contoso.com e ao grupo com o email group1@contoso.com.
Parâmetros
-FeatureId
Aplicável: Exchange Online
O parâmetro FeatureId especifica o recurso no módulo Viva para o qual você deseja exibir as políticas.
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
FeaturePolicy
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
FeaturePolicyWithMembers
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-MemberIds
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 parâmetro MemberIds especifica os usuários ou grupos específicos para os quais você deseja exibir as políticas do recurso no módulo Viva.
Você pode fornecer até três IDs de membro. Use o caractere * para especificar todos os módulos ou recursos.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
FeaturePolicyWithMembers
| Cargo: | Named |
| Obrigatório: | False |
| 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 das políticas de recursos que você deseja exibir.
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 |
-PolicyId
Aplicável: Exchange Online
O parâmetro PolicyId especifica a política específica para o recurso no módulo do Viva que você deseja exibir.
Para exibir detalhes sobre todas as políticas de um recurso em um módulo do Viva, execute este cmdlet sem o parâmetro PolicyId. Esses detalhes incluem os identificadores de todas as políticas de um recurso em um módulo do Viva.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
FeaturePolicy
| Cargo: | Positional |
| Obrigatório: | False |
| 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: | Microsoft.Exchange.Management.RestApiClient.Unlimited`1[System.UInt32] |
| 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.