Update-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 Update-VivaModuleFeaturePolicy para atualizar uma política de acesso para um recurso em um módulo do Viva no Viva.
- Você não poderá atualizar uma política para um determinado usuário ou grupo para incluir todo o locatário se já existir uma política para todo o locatário para o recurso. Há suporte apenas para uma política em 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)
Update-VivaModuleFeaturePolicy
-FeatureId <String>
-ModuleId <String>
-PolicyId <String>
[-Confirm]
[-Everyone <Boolean>]
[-IsFeatureEnabled <Boolean>]
[-IsUserControlEnabled <Boolean>]
[-IsUserOptedInByDefault <Boolean>]
[-GroupIds <String[]>]
[-Name <String>]
[-ResultSize <Unlimited>]
[-UserIds <String[]>]
[-WhatIf]
[<CommonParameters>]
Description
Use o cmdlet Update-VivaModuleFeaturePolicy para atualizar uma política de acesso para um recurso em um módulo do Viva no Viva.
Esse cmdlet atualiza os atributos da política que você especificar. Esses atributos incluem:
- O nome da política (parâmetro Name).
- Se a política habilita ou não o recurso (parâmetro IsFeatureEnabled).
- Se a política habilita ou não controles de usuário (parâmetro IsUserControlEnabled, aplicável somente a uma política de recursos).
- A quem a política se aplica (os parâmetros UserIds e GroupIds ou o parâmetro Everyone).
Você pode atualizar esses atributos independentemente uns dos outros. Por exemplo, se você especificar o parâmetro Name, mas não o parâmetro IsFeatureEnabled, o nome da política será atualizado, mas se a política habilitar ou não o recurso permanecerá inalterado.
Importante: os valores especificados para os parâmetros UserIds e/ou GroupIds ou o parâmetro Todos substituem quaisquer usuários ou grupos existentes. Para preservar os usuários e grupos existentes, você precisa especificar esses usuários ou grupos existentes e quaisquer usuários ou grupos adicionais que você deseja adicionar. Não incluir usuários ou grupos existentes no comando remove efetivamente esses usuários ou grupos específicos da política. Para obter mais informações, consulte os exemplos.
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
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b1 -Name NewPolicyName -IsFeatureEnabled $false
Este exemplo atualiza o nome da política especificada e faz com que a política não habilite o recurso.
Exemplo 2
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -GroupIds group1@contoso.com,group2@contoso.com
Este exemplo atualiza a quem a política especificada se aplica. A política agora se aplica somente aos grupos especificados, substituindo os usuários e grupos aos quais a política costumava ser aplicada.
Exemplo 3
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -UserIds user1@contoso.com,user2@contoso.com
Este exemplo atualiza a quem a política especificada se aplica. A política agora se aplica somente aos usuários especificados, substituindo os usuários e grupos aos quais a política costumava ser aplicada.
Exemplo 4
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -Name NewPolicyName -IsFeatureEnabled $true -GroupIds group1@contoso.com,57680382-61a5-4378-85ad-f72095d4e9c3 -UserIds user1@contoso.com
Este exemplo atualiza o nome da política especificada, faz com que a política habilite o recurso e atualiza a quem a política se aplica. A política agora se aplica somente aos usuários e grupos especificados, substituindo os usuários e grupos aos quais a política costumava ser aplicada.
Exemplo 5
Update-VivaModuleFeaturePolicy -ModuleId PeopleSkills -FeatureId ShowAISkills -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -IsFeatureEnabled $true -IsUserControlEnabled $true -IsUserOptedInByDefault $false
Este exemplo atualiza uma política para o recurso ShowAISkills no Viva Skills. A política habilita o recurso para os usuários adicionados anteriormente à política, 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.
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 parâmetro Everyone especifica que a política atualizada se aplica a todos os usuários da organização. Os valores válidos são:
- $true: A política se aplica a todos os usuários. Esse é o único valor útil para esse parâmetro.
- $false: Não use esse valor.
Se você não quiser atualizar a quem a política se aplica, não use esse parâmetro.
Não use esse parâmetro com os parâmetros GroupIds ou UserIds.
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 |
-FeatureId
Aplicável: Exchange Online
O parâmetro FeatureId especifica o recurso no módulo Viva da política que você deseja atualizar.
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
Se você não quiser atualizar a quem a política se aplica, não use esse parâmetro.
Os valores especificados para esse parâmetro ou para o parâmetro UserIds substituem todos os grupos existentes. Para preservar os grupos existentes, inclua-os juntamente com todos os novos usuários ou grupos que você especificar.
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 atualizada se aplique a todos os usuários da organização, use o parâmetro Todos com o valor $true.
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 pela política atualizada. Os valores válidos são:
- $true: o recurso está habilitado pela política.
- $false: o recurso não está habilitado pela política.
Se você não quiser atualizar se o recurso está habilitado pela política, não use esse parâmetro.
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 |
-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. Se o recurso der suporte a controles de usuário para recusa, certifique-se de definir o parâmetro IsUserControlEnabled ao criar a política. Caso contrário, os controles de usuário da política usarão o estado padrão do recurso.
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.
Se você não quiser atualizar se o controle do usuário está habilitado pela política, não use esse parâmetro.
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 Viva da política que você deseja atualizar.
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 atualizado para a 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.
Se você não quiser atualizar o nome da política, não use esse 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 |
-PolicyId
Aplicável: Exchange Online
O parâmetro PolicyId especifica a política para o recurso no módulo Viva que você deseja atualizar.
Para exibir detalhes sobre as políticas de um recurso em um módulo do Viva, use o cmdlet Get-VivaModuleFeaturePolicy. O valor PolicyId é 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 |
-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 atualizada se aplica. Update
Se você não quiser atualizar a quem a política se aplica, não use esse parâmetro.
Os valores especificados para esse parâmetro ou para o parâmetro GroupIds substituem os usuários existentes. Para preservar os usuários existentes, inclua-os junto com quaisquer novos usuários ou grupos que você especificar.
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 atualizada se aplique a todos os usuários da organização, use o parâmetro Todos com o valor $true.
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.