Update-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 Update-VivaModuleFeaturePolicy para atualizar uma política de acesso para uma funcionalidade num módulo de Viva no Viva.
- Não pode atualizar uma política para um determinado utilizador ou grupo incluir todo o inquilino se já existir uma política para todo o inquilino para a funcionalidade. Só é suportada uma política ao nível do 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)
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
Utilize o cmdlet Update-VivaModuleFeaturePolicy para atualizar uma política de acesso para uma funcionalidade num módulo de Viva no Viva.
Este cmdlet atualiza os atributos da política que especificar. Estes atributos incluem:
- O nome da política (parâmetro Nome).
- Se a política ativa ou não a funcionalidade (parâmetro IsFeatureEnabled).
- Se a política ativa ou não os controlos de utilizador (parâmetro IsUserControlEnabled, apenas aplicável a uma política de funcionalidades).
- A quem se aplica a política (os parâmetros UserIds e GroupIds ou o parâmetro Todos).
Pode atualizar estes atributos independentemente uns dos outros. Por exemplo, se especificar o parâmetro Nome, mas não o parâmetro IsFeatureEnabled, o nome da política é atualizado, mas se a política ativa ou não a funcionalidade permanece inalterada.
Importante: os valores que especificar para os parâmetros UserIds e/ou GroupIds ou o parâmetro Todos substituem todos os utilizadores ou grupos existentes. Para preservar os utilizadores e grupos existentes, tem de especificar esses utilizadores ou grupos existentes e quaisquer utilizadores ou grupos adicionais que pretenda adicionar. Não incluir utilizadores ou grupos existentes no comando remove efetivamente esses utilizadores ou grupos específicos da política. Para obter mais informações, veja os exemplos.
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
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 ative a funcionalidade.
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 se aplica a política especificada. A política aplica-se agora apenas aos grupos especificados, substituindo os utilizadores e grupos a que a política utilizada se aplica.
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 se aplica a política especificada. A política aplica-se agora apenas aos utilizadores especificados, substituindo os utilizadores e grupos aos quais a política utilizada se aplica.
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 ative a funcionalidade e atualize a quem a política se aplica. A política aplica-se agora apenas aos utilizadores e grupos especificados, substituindo os utilizadores e grupos aos quais a política utilizada se aplica.
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 a funcionalidade ShowAISkills no Viva Skills. A política ativa a funcionalidade para os utilizadores adicionados anteriormente à política, 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.
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 Todos especifica que a política atualizada se aplica a todos os utilizadores na organização. Os valores válidos são:
- $true: a política aplica-se a todos os utilizadores. Este é o único valor útil para este parâmetro.
- $false: não utilize este valor.
Se não quiser atualizar a quem a política se aplica, não utilize este parâmetro.
Não utilize este 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 a funcionalidade no módulo Viva da política que pretende atualizar.
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
Se não quiser atualizar a quem a política se aplica, não utilize este parâmetro.
Os valores que especificar para este parâmetro ou o parâmetro UserIds substituem todos os grupos existentes. Para preservar os grupos existentes, inclua-os juntamente com os novos utilizadores ou grupos que especificar.
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 atualizada se aplique a todos os utilizadores na organização, utilize o parâmetro Todos com o valor $true.
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á ativada pela política atualizada. Os valores válidos são:
- $true: a funcionalidade é ativada pela política.
- $false: a funcionalidade não está ativada pela política.
Se não quiser atualizar se a funcionalidade está ativada pela política, não utilize este 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
Nota: este parâmetro está disponível na versão 3.3.0-Preview1 ou posterior do módulo. Se a funcionalidade suportar controlos de utilizador para optar ativamente por não participar, certifique-se de que define o parâmetro IsUserControlEnabled quando criar a política. Caso contrário, os controlos de utilizador da política utilizam o estado predefinido da funcionalidade.
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.
Se não quiser atualizar se o controlo de utilizador está ativado pela política, não utilize este 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
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 da política que pretende 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 Nome 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 carateres válidos são letras, números, vírgulas, pontos finais e espaços em inglês.
Se não quiser atualizar o nome da política, não utilize 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 |
-PolicyId
Aplicável: Exchange Online
O parâmetro PolicyId especifica a política para a funcionalidade no módulo Viva que pretende atualizar.
Para ver detalhes sobre as políticas de uma funcionalidade num módulo Viva, utilize o cmdlet Get-VivaModuleFeaturePolicy. O valor PolicyId é 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 |
-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 atualizada se aplica. Update
Se não quiser atualizar a quem a política se aplica, não utilize este parâmetro.
Os valores que especificar para este parâmetro ou o parâmetro GroupIds substituem todos os utilizadores existentes. Para preservar os utilizadores existentes, inclua-os juntamente com quaisquer novos utilizadores ou grupos que especificar.
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 atualizada se aplique a todos os utilizadores na organização, utilize 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 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.