Add-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 Add-VivaModuleFeaturePolicy para adicionar uma nova política de acesso para um recurso específico no Viva. Os atributos da política são definidos usando os vários parâmetros do cmdlet. As políticas são usadas para restringir ou conceder acesso ao recurso especificado para usuários, grupos ou todo o locatário específico. Observe que 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
Add-VivaModuleFeaturePolicy
-FeatureId <String>
-IsFeatureEnabled <Boolean>
-ModuleId <String>
-Name <String>
[-Confirm]
[-GroupIds <String[]>]
[-UserIds <String[]>]
[-Everyone]
[-ResultSize <Unlimited>]
[-WhatIf]
[<CommonParameters>] Description
Use o cmdlet Add-VivaModuleFeaturePolicy para adicionar uma nova política de acesso para um recurso específico no Viva.
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
Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name DisableFeatureForAll -IsFeatureEnabled $false -EveryoneEste exemplo adiciona uma política para o recurso Reflexão no Viva Insights. A política desabilita o recurso para todos os usuários da organização.
Exemplo 2
Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name MultipleGroups -IsFeatureEnabled $false -GroupIds group1@contoso.com,group2@contoso.comEste exemplo adiciona uma política para o recurso Reflexão no Viva Insights. A política desabilita o recurso para todos os usuários 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 o recurso Reflexão no Viva Insights. A política desabilita o recurso para os usuários especificados.
Exemplo 4
Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name UsersAndGroups -IsFeatureEnabled $false -GroupIds group1@contoso.com,group2@contoso.com -UserIds user1@contoso.com,user2@contoso.comEste exemplo adiciona uma política para o recurso Reflexão no Viva Insights. A política desabilita o recurso para os usuários e membros do grupo especificados.
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
A opção Todos especifica que a política se aplica a todos os usuários da organização. Não é preciso especificar um valor com essa opção.
Não use essa opção com os parâmetros GroupIds ou UserIds.
| Type: | SwitchParameter |
| 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 para o qual você deseja adicionar a política.
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 SMTP (endereços de email) dos grupos aos quais a política se aplica. Há suporte para grupos de AAD habilitados para email. Update
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 se aplique a todos os usuários da organização, use a opção Todos.
| 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 ou não pela política. Os valores válidos são:
- $true: o recurso está habilitado pela política.
- $false: o recurso não está habilitado pela política.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ModuleId
O parâmetro ModuleId especifica o módulo Viva para o qual você deseja adicionar a política de recursos.
| 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 Name especifica o nome da 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.
| 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 se aplica. Update
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 se aplique a todos os usuários da organização, use a opção Todos.
| 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 |