Add-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 Add-VivaModuleFeaturePolicy para adicionar uma nova política de acesso para um recurso específico no Viva. Os atributos da política são definidos usando os parâmetros de cmdlet. 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.
- Você pode atribuir até 10 políticas por recurso. Uma política adicional por recurso pode ser atribuída a todo o locatário.
- As políticas atribuídas a um usuário ou grupo específico têm prioridade sobre a política atribuída a todo o locatário ao determinar se um recurso está habilitado. Se um usuário tiver várias políticas atribuídas a um recurso (diretamente como usuário ou membro de um grupo), a política mais restritiva será aplicada.
- Alguns recursos dão suporte apenas a políticas que se aplicam a todo o locatário, não a usuários ou grupos específicos. Você pode consultar os escopos de política com suporte para um recurso usando o cmdlet Get-VivaModuleFeature .
Alguns recursos incluem a opção de controles do usuário (recusa do usuário). Consulte a documentação do recurso para ver se os controles de usuário estão disponíveis para o recurso para o qual você pretende definir uma política.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Default)
Add-VivaModuleFeaturePolicy
-FeatureId <String>
-IsFeatureEnabled <Boolean>
-ModuleId <String>
-Name <String>
[-Confirm]
[-Everyone]
[-GroupIds <String[]>]
[-IsUserControlEnabled <Boolean>]
[-IsUserOptedInByDefault <Boolean>]
[-ResultSize <Unlimited>]
[-UserIds <String[]>]
[-WhatIf]
[<CommonParameters>]
Description
Use o cmdlet Add-VivaModuleFeaturePolicy para adicionar uma nova política de acesso para um recurso específico no Viva.
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
Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name DisableFeatureForAll -IsFeatureEnabled $false -Everyone
Este exemplo adiciona uma política para o recurso Reflexão no Viva Insights. A política desabilita o recurso para todos os usuários na organização.
Exemplo 2
Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name MultipleGroups -IsFeatureEnabled $false -GroupIds group1@contoso.com,group2@contoso.com,57680382-61a5-4378-85ad-f72095d4e9c3
Este exemplo adiciona uma política para o recurso Reflexão no Viva Insights. A política desabilita o recurso para todos os usuários nos grupos especificados.
Exemplo 3
Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name MultipleUsers -IsFeatureEnabled $false -UserIds user1@contoso.com,user2@contoso.com
Este exemplo adiciona uma política para o recurso Reflexão no Viva Insights. A política desabilita o recurso para os usuários especificados.
Exemplo 4
Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name UsersAndGroups -IsFeatureEnabled $false -GroupIds group1@contoso.com,group2@contoso.com,57680382-61a5-4378-85ad-f72095d4e9c3 -UserIds user1@contoso.com,user2@contoso.com
Este exemplo adiciona uma política para o recurso Reflexão no Viva Insights. A política desabilita o recurso para os usuários e membros do grupo especificados.
Exemplo 5
Add-VivaModuleFeaturePolicy -ModuleId PeopleSkills -FeatureId ShowAISkills -Name SoftDisableShowAISkillsPolicy -IsFeatureEnabled $true -IsUserControlEnabled $true -IsUserOptedInByDefault $false -UserIds user1@contoso.com,user2@contoso.com
Este exemplo adiciona uma política para o recurso ShowAISkills no Viva Skills. A política habilita o recurso para os usuários especificados, permite controles de usuário e usuários recusados por padrão (política de Desabilitação Suave).
Parâmetros
-Confirm
Aplicável: Exchange Online
A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer confirmação antes de continuar.
- Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false. - A maioria dos outros cmdlets (por exemplo, New- e Set-) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a reconhecer o comando antes de continuar.
Este cmdlet tem uma pausa interna, portanto, use -Confirm:$false para ignorar a confirmação.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
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 |
-Everyone
Aplicável: Exchange Online
O comutador Todos especifica que a política se aplica a todos os usuários da organização. Não é preciso especificar um valor com essa opção.
Não use essa opção com os parâmetros GroupIds ou UserIds.
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 o qual você deseja adicionar a política.
Para exibir detalhes sobre os recursos em um módulo do Viva que dão suporte a controles de acesso a recursos, use o cmdlet Get-VivaModuleFeature. O valor FeatureId é retornado na saída do cmdlet.
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 |
-GroupIds
Aplicável: Exchange Online
O parâmetro GroupIds especifica os endereços de email ou IDs de objeto de grupo de segurança (GUIDs) de grupos aos quais a política atualizada se aplica. Há suporte para grupos do Microsoft Entra habilitados para email e não habilitados para email. Update
Você pode especificar no máximo 20 usuários ou grupos no total (20 usuários e nenhum grupo, 10 usuários e 10 grupos, etc.).
Para que a política se aplique a todos os usuários da organização, use a opção Todos.
Observação: na v3.5.1-Preview2 ou posterior do módulo, esse parâmetro dá suporte a IDs de objeto de grupo de segurança (GUIDs). As versões anteriores do módulo aceitam apenas endereços de email para este parâmetro.
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 |
-IsFeatureEnabled
Aplicável: Exchange Online
O parâmetro IsFeatureEnabled especifica se o recurso está habilitado ou não pela política. Os valores válidos são:
- $true: o recurso está habilitado pela política.
- $false: o recurso não está habilitado pela política.
Propriedades do parâmetro
| Tipo: | Boolean |
| 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 |
-IsUserControlEnabled
Aplicável: Exchange Online
Observação: este parâmetro está disponível na versão 3.3.0-Preview1 ou posterior do módulo.
O parâmetro IsUserControlEnabled especifica se o controle do usuário está habilitado pela política. Os valores válidos são:
- $true: O controle de usuário é habilitado pela política. Os usuários podem recusar o recurso.
- $false: o controle do usuário não está habilitado pela política. Os usuários não podem optar pelo recurso.
Somente os recursos que permitem que os administradores habilitem e desabilitem os controles de usuário por política podem usar esse parâmetro. Se o recurso não der suporte a administradores alternando controles de usuário, o valor padrão será aplicado. Consulte a documentação do recurso para obter mais informações.
Propriedades do parâmetro
| Tipo: | Boolean |
| 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 |
-IsUserOptedInByDefault
Aplicável: Exchange Online
Observação: este parâmetro está disponível na versão do módulo 3.8.0-Preview2 ou posterior.
O parâmetro IsUserOptedInByDefault especifica se os usuários são aceitos por padrão pela política. Os valores válidos são:
- $true: por padrão, os usuários são aceitos pela política se o usuário não tiver definido uma preferência.
- $false: por padrão, os usuários são recusados pela política se o usuário não tiver definido uma preferência.
Esse parâmetro é opcional e pode ser usado para substituir o valor de aceitação do usuário padrão definido nos metadados do recurso.
Esse parâmetro só pode ser definido quando o parâmetro IsUserControlEnabled é definido como $true.
Propriedades do parâmetro
| Tipo: | Boolean |
| 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 |
-ModuleId
Aplicável: Exchange Online
O parâmetro ModuleId especifica o módulo do Viva para o qual você deseja adicionar a política de recursos.
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 |
-Name
Aplicável: Exchange Online
O parâmetro Name especifica o nome da política. O comprimento máximo é de 256 caracteres. Se o valor contiver espaços, coloque-o entre aspas (").
Os caracteres válidos são letras em inglês, números, vírgulas, pontos e espaços.
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 |
-UserIds
Aplicável: Exchange Online
O parâmetro UserIds especifica os nomes principais do usuário (UPNs) dos usuários aos quais a política se aplica. Update
Você pode especificar no máximo 20 usuários ou grupos no total (20 usuários e nenhum grupo, 10 usuários e 10 grupos, etc.).
Para que a política se aplique a todos os usuários da organização, use a opção Todos.
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 |
-WhatIf
Aplicável: Exchange Online
A opção WhatIf mostra o que o comando faz sem fazer nenhuma alteração. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
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.