Update-VivaModuleFeaturePolicy
Esse cmdlet só está disponível no módulo Exchange Online PowerShell v3.2.0 ou posterior. Para obter mais informações, consulte Sobre o módulo Exchange Online PowerShell.
Observação: este cmdlet faz parte de um recurso que está atualmente em uma versão prévia privada fechada. O cmdlet não funcionará a menos que sua organização seja membro da Versão Prévia Privada.
Use o cmdlet Update-VivaModuleFeaturePolicy para atualizar uma política de acesso para um recurso em um módulo do Viva. A política mais restritiva para um determinado usuário ou grupo tem prioridade ao determinar se um recurso está habilitado.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Syntax
Update-VivaModuleFeaturePolicy
-FeatureId <String>
-ModuleId <String>
-PolicyId <String>
[-Confirm]
[-IsFeatureEnabled <Boolean>]
[-GroupIds <String[]>]
[-Everyone <Boolean>]
[-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.
Este cmdlet atualiza os atributos da política especificada. Esses atributos incluem:
- O nome da política (parâmetro Name).
- Se a política habilita ou não o recurso (parâmetro IsFeatureEnabled).
- A quem a política se aplica (os parâmetros UserIds e GroupIds ou o parâmetro Todos).
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 habilita ou não o recurso permanece inalterado.
Importante: os valores especificados para os parâmetros UserIds e/ou GroupIds ou o parâmetro Todos substituem todos os 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, confira os exemplos.
Você precisa usar o cmdlet Connect-ExchangeOnline para autenticar.
Esse cmdlet requer o .NET Framework 4.7.2 ou posterior.
Atualmente, você precisa ser um membro da função administradores globais para executar esse cmdlet.
Para saber mais sobre as permissões de função de administrador no Azure Active Directory, consulte IDs de modelo de função.
Exemplos
Exemplo 1
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b1 -Name NewPolicyName -IsFeatureEnabled $falseEste exemplo atualiza o nome da política especificada e a torna para 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.comEste exemplo atualiza a quem a política especificada se aplica. A política agora se aplica apenas aos grupos especificados, substituindo os usuários e agrupando a política usada para se aplicar.
Exemplo 3
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -UserIds user1@contoso.com,user2@contoso.comEste exemplo atualiza a quem a política especificada se aplica. A política agora se aplica apenas aos usuários especificados, substituindo os usuários e agrupando a política usada para se aplicar.
Exemplo 4
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -Name NewPolicyName -IsFeatureEnabled $true -GroupIds group1@contoso.com -UserIds user1@contoso.comEste exemplo atualiza o nome da política especificada, faz com que a política habilite o recurso e atualize a quem a política se aplica. A política agora se aplica apenas aos usuários e grupos especificados, substituindo os usuários e os grupos aos quais a política usada para se aplicar.
Parâmetros
-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, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false. - A maioria dos outros cmdlets (por exemplo, cmdlets 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.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Everyone
O parâmetro Todos 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-FeatureId
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á suporte a controles de acesso de recursos, use o cmdlet Get-VivaModuleFeature. O valor FeatureId é retornado na saída do cmdlet.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-GroupIds
O parâmetro GroupIds especifica os endereços de email de grupos aos quais a política atualizada se aplica. Há suporte para grupos de AAD 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 o parâmetro UserIds substituem todos os grupos existentes. Para preservar os grupos existentes, inclua-os junto com novos usuários ou grupos que você especificar.
Você pode especificar um máximo de 20 usuários ou grupos totais (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.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-IsFeatureEnabled
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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ModuleId
O parâmetro ModuleId especifica o módulo Viva da política que você deseja atualizar.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Name
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 (").
Caracteres válidos são letras, números, vírgulas, períodos e espaços em inglês.
Se você não quiser atualizar o nome da política, não use esse parâmetro.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-PolicyId
O parâmetro PolicyId especifica a política do recurso no módulo Do 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ResultSize
Esse parâmetro está reservado para uso interno da Microsoft.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-UserIds
O parâmetro UserIds especifica os UPNs (nomes de entidade de usuário) 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 o parâmetro GroupIds substituem os usuários existentes. Para preservar os usuários existentes, inclua-os junto com novos usuários ou grupos que você especificar.
Você pode especificar um máximo de 20 usuários ou grupos totais (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.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |