Add-VivaModuleFeaturePolicy
Este cmdlet só está disponível no módulo Exchange Online PowerShell v3.2.0 ou posterior. Para obter mais informações, veja Acerca do módulo Exchange Online PowerShell.
Nota: o suporte para categorias está disponível na versão 3.5.0-Preview2 ou posterior do módulo, mas não existem categorias atualmente disponíveis no Viva. Atualizaremos a documentação quando estiverem disponíveis categorias.
Utilize o cmdlet Add-VivaModuleFeaturePolicy para adicionar uma nova política de acesso para uma funcionalidade específica ou uma categoria no Viva. Os atributos da política são definidos com os parâmetros do cmdlet. As políticas são utilizadas para restringir ou conceder acesso à funcionalidade ou categoria especificada para utilizadores, grupos ou todo o inquilino específicos.
- Pode atribuir até 10 políticas por funcionalidade/categoria. Uma política adicional por funcionalidade/categoria pode ser atribuída a todo o inquilino.
- As políticas atribuídas a um utilizador ou grupo específico têm prioridade sobre a política atribuída a todo o inquilino ao determinar se uma funcionalidade/categoria está ativada. Se um utilizador tiver várias políticas atribuídas para uma funcionalidade/categoria (diretamente como utilizador ou membro de um grupo), aplica-se a política mais restritiva.
- Se uma categoria estiver desativada por políticas de categoria, todas as funcionalidades na categoria serão desativadas independentemente das políticas definidas ao nível da funcionalidade.
- Só pode atualizar os controlos de utilizador ao nível da política de funcionalidades e não ao nível da política de categoria.
- Algumas funcionalidades suportam apenas políticas que se aplicam a todo o inquilino e não a utilizadores ou grupos específicos. Pode consultar os âmbitos de política suportados para uma funcionalidade com o cmdlet Get-VivaModuleFeature .
Algumas funcionalidades incluem a opção para controlos de utilizador (optar ativamente por não participar). Veja a documentação da funcionalidade para ver se existem controlos de utilizador disponíveis para a funcionalidade para a qual pretende definir uma política.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Add-VivaModuleFeaturePolicy
-FeatureId <String>
-IsFeatureEnabled <Boolean>
-ModuleId <String>
-Name <String>
[-Confirm]
[-Everyone]
[-GroupIds <String[]>]
[-IsUserControlEnabled <Boolean>]
[-ResultSize <Unlimited>]
[-UserIds <String[]>]
[-WhatIf]
[<CommonParameters>] Add-VivaModuleFeaturePolicy
-CategoryId <String>
-IsCategoryEnabled <Boolean>
-Name <String>
[-Confirm]
[-Everyone]
[-GroupIds <String[]>]
[-ResultSize <Unlimited>]
[-UserIds <String[]>]
[-WhatIf]
[<CommonParameters>] Description
Utilize o cmdlet Add-VivaModuleFeaturePolicy para adicionar uma nova política de acesso a uma funcionalidade ou categoria específica no Viva.
O suporte para categorias está disponível na versão 3.5.0-Preview2 ou posterior do módulo.
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 ou das funções que foram atribuídas ao nível da funcionalidade para executar este cmdlet.
Para saber mais sobre as funções atribuídas ao nível da funcionalidade, veja Funcionalidades Disponíveis para a Gestão de Acesso a Funcionalidades.
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 recomenda que você use funções com o menor número de permissões. A utilização de contas com permissões mais baixas ajuda a melhorar a segurança da sua organização. O Administrador Global é uma função altamente privilegiada que deve ser limitada a cenários de emergência quando não for possível usar uma função existente.
Exemplos
Exemplo 1
Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name DisableFeatureForAll -IsFeatureEnabled $false -EveryoneEste exemplo adiciona uma política para a funcionalidade Reflexão no Viva Insights. A política desativa a funcionalidade para todos os utilizadores 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-f72095d4e9c3Este exemplo adiciona uma política para a funcionalidade Reflexão no Viva Insights. A política desativa a funcionalidade para todos os utilizadores nos grupos especificados.
Exemplo 3
Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name MultipleUsers -IsFeatureEnabled $false -UserIds user1@contoso.com,user2@contoso.comEste exemplo adiciona uma política para a funcionalidade Reflexão no Viva Insights. A política desativa a funcionalidade para os utilizadores 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.comEste exemplo adiciona uma política para a funcionalidade Reflexão no Viva Insights. A política desativa a funcionalidade para os utilizadores e membros do grupo especificados.
Exemplo 5
Add-VivaModuleFeaturePolicy -CategoryId <category_id> -Name DisableCategoryForAll -IsCategoryEnabled $false -EveryoneEste exemplo adiciona uma política para a <category_id> categoria no Viva. A política desativa a categoria (efetivamente todas as funcionalidades na categoria) para todos os utilizadores na organização.
Exemplo 6
Add-VivaModuleFeaturePolicy -CategoryId <category_id> -Name MultipleGroups -IsCategoryEnabled $false -GroupIds group1@contoso.com,group2@contoso.com,57680382-61a5-4378-85ad-f72095d4e9c3Este exemplo adiciona uma política para a <category_id> categoria no Viva. A política desativa a categoria (efetivamente todas as funcionalidades na categoria) para todos os utilizadores nos grupos especificados.
Exemplo 7
Add-VivaModuleFeaturePolicy -CategoryId <category_id> -Name MultipleUsers -IsCategoryEnabled $false -UserIds user1@contoso.com,user2@contoso.comEste exemplo adiciona uma política para a <category_id> categoria no Viva. A política desativa a categoria (efetivamente todas as funcionalidades na categoria) para os utilizadores especificados.
Exemplo 8
Add-VivaModuleFeaturePolicy -CategoryId <category_id> -Name UsersAndGroups -IsCategoryEnabled $false -GroupIds group1@contoso.com,group2@contoso.com,57680382-61a5-4378-85ad-f72095d4e9c3 -UserIds user1@contoso.com,user2@contoso.comEste exemplo adiciona uma política para a <category_id> categoria no Viva. A política desativa a categoria (efetivamente todas as funcionalidades na categoria) para os utilizadores e membros do grupo especificados.
Exemplo 9
Add-VivaModuleFeaturePolicy -CategoryId <category_id> -Name "Disable Category For All" -IsCategoryEnabled $false -EveryoneEste exemplo adiciona uma política para a <category_id> categoria no Viva em que o nome da política está com espaços. A política desativa a categoria (efetivamente todas as funcionalidades na categoria) para todos os utilizadores na organização.
Parâmetros
-CategoryId
Este parâmetro está disponível na versão 3.5.0-Preview2 ou posterior do módulo.
Nota: atualmente, não existem categorias disponíveis no Viva. Atualizaremos a documentação quando estiverem disponíveis categorias.
O parâmetro CategoryId especifica a categoria Viva para a qual pretende adicionar a política.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Exchange Online |
-Confirm
A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não 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 confirmar o comando antes de continuar.
Este cmdlet tem uma pausa incorporada, pelo que deve utilizar -Confirm:$false para ignorar a confirmação.
| Tipo: | SwitchParameter |
| Aliases: | cf |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Exchange Online |
-Everyone
O comutador Todos especifica que a política se aplica a todos os utilizadores na organização. Não é preciso especificar um valor com essa opção.
Não utilize este comutador com os parâmetros GroupIds ou UserIds.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Exchange Online |
-FeatureId
O parâmetro FeatureId especifica a funcionalidade no módulo Viva para o qual pretende adicionar a política.
Para ver detalhes sobre as funcionalidades num módulo Viva que suportam controlos de acesso a funcionalidades, utilize o cmdlet Get-VivaModuleFeature. O valor FeatureId é devolvido na saída do cmdlet.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Exchange Online |
-GroupIds
O parâmetro GroupIds especifica os endereços de e-mail ou os IDs de objeto do grupo de segurança (GUIDs) dos grupos aos quais a política atualizada se aplica. Os grupos de Microsoft Entra com capacidade de correio e não com capacidade de correio são suportados. Update
Pode especificar um máximo de 20 utilizadores ou grupos totais (20 utilizadores e nenhum grupo, 10 utilizadores e 10 grupos, etc.).
Para que a política se aplique a todos os utilizadores na organização, utilize o comutador Todos.
Nota: na v3.5.1-Preview2 ou posterior do módulo, este parâmetro suporta IDs de objetos de grupo de segurança (GUIDs). As versões anteriores do módulo só aceitam endereços de e-mail para este parâmetro.
| Tipo: | String[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Exchange Online |
-IsCategoryEnabled
Este parâmetro está disponível na versão 3.5.0-Preview2 ou posterior do módulo.
Nota: atualmente, não existem categorias disponíveis no Viva. Atualizaremos a documentação quando estiverem disponíveis categorias.
O parâmetro IsCategoryEnabled especifica se a categoria está ou não ativada pela política. Os valores válidos são:
- $true: a categoria é ativada pela política.
- $false: a categoria não está ativada pela política.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Exchange Online |
-IsFeatureEnabled
O parâmetro IsFeatureEnabled especifica se a funcionalidade está ou não ativada pela política. Os valores válidos são:
- $true: a funcionalidade é ativada pela política.
- $false: a funcionalidade não está ativada pela política.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Exchange Online |
-IsUserControlEnabled
Este parâmetro está disponível na versão 3.3.0 ou posterior do módulo.
O parâmetro IsUserControlEnabled especifica se o controlo do utilizador está ativado pela política. Os valores válidos são:
- $true: o controlo de utilizador é ativado pela política. Os utilizadores podem optar ativamente por não participar na funcionalidade.
- $false: o controlo de utilizador não está ativado pela política. Os utilizadores não podem optar pela funcionalidade.
Apenas as funcionalidades que permitem aos administradores ativar e desativar os controlos de utilizador por política podem utilizar este parâmetro. Se a funcionalidade não suportar administradores que alterem os controlos de utilizador, aplica-se o valor predefinido. Veja a documentação da funcionalidade para obter mais informações.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Exchange Online |
-ModuleId
O parâmetro ModuleId especifica o módulo Viva para o qual pretende adicionar a política de funcionalidades.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Exchange Online |
-Name
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 carateres válidos são letras, números, vírgulas, pontos finais e espaços em inglês.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Exchange Online |
-ResultSize
Esse parâmetro está reservado para uso interno da Microsoft.
| Tipo: | Unlimited |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Exchange Online |
-UserIds
O parâmetro UserIds especifica os nomes principais de utilizador (UPNs) dos utilizadores aos quais a política se aplica. Update
Pode especificar um máximo de 20 utilizadores ou grupos totais (20 utilizadores e nenhum grupo, 10 utilizadores e 10 grupos, etc.).
Para que a política se aplique a todos os utilizadores na organização, utilize o comutador Todos.
| Tipo: | String[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Exchange Online |
-WhatIf
A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.
| Tipo: | SwitchParameter |
| Aliases: | wi |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
| Aplica-se a: | Exchange Online |