Add-VivaModuleFeaturePolicy
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 Add-VivaModuleFeaturePolicy para adicionar uma nova política de acesso para uma funcionalidade específica 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 especificada para utilizadores, grupos ou todo o inquilino específicos.
- Pode atribuir até 10 políticas por funcionalidade. Uma política adicional por funcionalidade 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 está ativada. Se um utilizador tiver várias políticas atribuídas a uma funcionalidade (diretamente como utilizador ou membro de um grupo), aplica-se a política mais restritiva.
- 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
Default (Padrão)
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
Utilize o cmdlet Add-VivaModuleFeaturePolicy para adicionar uma nova política de acesso para uma funcionalidade específica no Viva.
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 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
Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name DisableFeatureForAll -IsFeatureEnabled $false -Everyone
Este 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-f72095d4e9c3
Este 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.com
Este 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.com
Este 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 -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 a funcionalidade ShowAISkills no Viva Skills. A política ativa a funcionalidade para os utilizadores especificados, permite controlos de utilizador e optou ativamente por não participar nos utilizadores por predefinição (Política de Desativação Recuperável).
Parâmetros
-Confirm
Aplicável: Exchange Online
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.
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 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.
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 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.
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 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.
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 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.
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
Nota: 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 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.
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
Nota: este parâmetro está disponível na versão 3.8.0-Preview2 ou posterior do módulo.
O parâmetro IsUserOptedInByDefault especifica se os utilizadores optaram por participar por predefinição pela política. Os valores válidos são:
- $true: por predefinição, os utilizadores são optados pela política se o utilizador não tiver definido uma preferência.
- $false: por predefinição, os utilizadores são excluídos da política se o utilizador não tiver definido uma preferência.
Este parâmetro é opcional e pode ser utilizado para substituir o conjunto de valores predefinidos de opção de opt-in do utilizador nos metadados da funcionalidade.
Este parâmetro só pode ser definido quando o parâmetro IsUserControlEnabled está 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 Viva para o qual pretende adicionar a política de funcionalidades.
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 carateres válidos são letras, números, vírgulas, pontos finais e espaços em inglês.
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 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.
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 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.
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 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.