Add-VivaModuleFeaturePolicy
Este cmdlet solo está disponible en Exchange Online módulo de PowerShell v3.2.0 o posterior. Para obtener más información, vea Acerca de la Exchange Online módulo de PowerShell.
Nota: La compatibilidad con categorías está disponible en la versión 3.5.0-Preview2 o posterior del módulo, pero actualmente no hay ninguna categoría disponible en Viva. Actualizaremos la documentación cuando haya categorías disponibles.
Use el cmdlet Add-VivaModuleFeaturePolicy para agregar una nueva directiva de acceso para una característica específica o una categoría en Viva. Los atributos de la directiva se definen mediante los parámetros de cmdlet. Las directivas se usan para restringir o conceder acceso a la característica o categoría especificada para usuarios, grupos o todo el inquilino específicos.
- Puede asignar hasta 10 directivas por característica o categoría. Se puede asignar una directiva adicional por característica o categoría a todo el inquilino.
- Las directivas asignadas a un usuario o grupo específico tienen prioridad sobre la directiva asignada a todo el inquilino al determinar si una característica o categoría está habilitada. Si un usuario tiene varias directivas asignadas para una característica o categoría (directamente como usuario o miembro de un grupo), se aplica la directiva más restrictiva.
- Si una categoría está deshabilitada por las directivas de categoría, todas las características de la categoría se deshabilitan independientemente de las directivas establecidas en el nivel de característica.
- Solo puede actualizar los controles de usuario en el nivel de directiva de características, no en el nivel de directiva de categoría.
- Algunas características solo admiten directivas que se aplican a todo el inquilino, no a usuarios o grupos específicos. Puede hacer referencia a los ámbitos de directiva admitidos para una característica mediante el cmdlet Get-VivaModuleFeature .
Algunas características incluyen la opción para los controles de usuario (exclusión del usuario). Consulte la documentación de la característica para ver si los controles de usuario están disponibles para la característica para la que pretende establecer una directiva.
Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.
Sintaxis
Add-VivaModuleFeaturePolicy
-FeatureId <String>
-IsFeatureEnabled <Boolean>
-ModuleId <String>
-Name <String>
[-Confirm]
[-Everyone]
[-GroupIds <String[]>]
[-IsUserControlEnabled <Boolean>]
[-ResultSize <Unlimited>]
[-UserIds <String[]>]
[-WhatIf]
[<CommonParameters>] Add-VivaModuleFeaturePolicy
-CategoryId <String>
-IsCategoryEnabled <Boolean>
-Name <String>
[-Confirm]
[-Everyone]
[-GroupIds <String[]>]
[-ResultSize <Unlimited>]
[-UserIds <String[]>]
[-WhatIf]
[<CommonParameters>] Description
Use el cmdlet Add-VivaModuleFeaturePolicy para agregar una nueva directiva de acceso para una característica o categoría específica en Viva.
La compatibilidad con categorías está disponible en la versión 3.5.0-Preview2 o posterior del módulo.
Debe usar el cmdlet Connect-ExchangeOnline para autenticarse.
Este cmdlet requiere .NET Framework 4.7.2 o posterior.
Actualmente, debe ser miembro del rol Administradores globales o de los roles que se han asignado en el nivel de característica para ejecutar este cmdlet.
Para obtener más información sobre los roles asignados en el nivel de característica, consulte Características disponibles para la administración de acceso a características.
Para obtener más información sobre los permisos de rol de administrador en Microsoft Entra ID, consulte Identificadores de plantilla de rol.
Importante
Microsoft recomienda utilizar roles con la menor cantidad de permisos. El uso de cuentas con permisos inferiores ayuda a mejorar la seguridad de su organización. Administrador global es un rol con muchos privilegios que debe limitarse a escenarios de emergencia cuando no se puede usar un rol existente.
Ejemplos
Ejemplo 1
Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name DisableFeatureForAll -IsFeatureEnabled $false -EveryoneEn este ejemplo se agrega una directiva para la característica Reflexión en Viva Insights. La directiva deshabilita la característica para todos los usuarios de la organización.
Ejemplo 2
Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name MultipleGroups -IsFeatureEnabled $false -GroupIds group1@contoso.com,group2@contoso.com,57680382-61a5-4378-85ad-f72095d4e9c3En este ejemplo se agrega una directiva para la característica Reflexión en Viva Insights. La directiva deshabilita la característica para todos los usuarios de los grupos especificados.
Ejemplo 3
Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name MultipleUsers -IsFeatureEnabled $false -UserIds user1@contoso.com,user2@contoso.comEn este ejemplo se agrega una directiva para la característica Reflexión en Viva Insights. La directiva deshabilita la característica para los usuarios especificados.
Ejemplo 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.comEn este ejemplo se agrega una directiva para la característica Reflexión en Viva Insights. La directiva deshabilita la característica para los usuarios y miembros del grupo especificados.
Ejemplo 5
Add-VivaModuleFeaturePolicy -CategoryId <category_id> -Name DisableCategoryForAll -IsCategoryEnabled $false -EveryoneEn este ejemplo se agrega una directiva para la <category_id> categoría de Viva. La directiva deshabilita la categoría (de hecho, todas las características de la categoría) para todos los usuarios de la organización.
Ejemplo 6
Add-VivaModuleFeaturePolicy -CategoryId <category_id> -Name MultipleGroups -IsCategoryEnabled $false -GroupIds group1@contoso.com,group2@contoso.com,57680382-61a5-4378-85ad-f72095d4e9c3En este ejemplo se agrega una directiva para la <category_id> categoría de Viva. La directiva deshabilita la categoría (de hecho, todas las características de la categoría) para todos los usuarios de los grupos especificados.
Ejemplo 7
Add-VivaModuleFeaturePolicy -CategoryId <category_id> -Name MultipleUsers -IsCategoryEnabled $false -UserIds user1@contoso.com,user2@contoso.comEn este ejemplo se agrega una directiva para la <category_id> categoría de Viva. La directiva deshabilita la categoría (de hecho, todas las características de la categoría) para los usuarios especificados.
Ejemplo 8
Add-VivaModuleFeaturePolicy -CategoryId <category_id> -Name UsersAndGroups -IsCategoryEnabled $false -GroupIds group1@contoso.com,group2@contoso.com,57680382-61a5-4378-85ad-f72095d4e9c3 -UserIds user1@contoso.com,user2@contoso.comEn este ejemplo se agrega una directiva para la <category_id> categoría de Viva. La directiva deshabilita la categoría (de hecho, todas las características de la categoría) para los usuarios y miembros del grupo especificados.
Ejemplo 9
Add-VivaModuleFeaturePolicy -CategoryId <category_id> -Name "Disable Category For All" -IsCategoryEnabled $false -EveryoneEn este ejemplo se agrega una directiva para la <category_id> categoría en Viva donde el nombre de la directiva es con espacios. La directiva deshabilita la categoría (de hecho, todas las características de la categoría) para todos los usuarios de la organización.
Parámetros
-CategoryId
Este parámetro está disponible en la versión 3.5.0-Preview2 o posterior del módulo.
Nota: Actualmente, no hay categorías disponibles en Viva. Actualizaremos la documentación cuando haya categorías disponibles.
El parámetro CategoryId especifica la categoría de Viva para la que desea agregar la directiva.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
| Se aplica a: | Exchange Online |
-Confirm
El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador el cmdlet depende de si el cmdlet requiere confirmación antes de continuar.
- Los cmdlets destructivos (por ejemplo, los cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta:
-Confirm:$false. - La mayoría de los otros cmdlets (por ejemplo, New-* y Set-*) no tienen una pausa integrada. En estos cmdlets, si se especifica el modificador Confirm sin ningún valor, se introduce una pausa que obliga a confirmar el comando antes de continuar.
Este cmdlet tiene una pausa integrada, por lo que debe usar -Confirm:$false para omitir la confirmación.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
| Se aplica a: | Exchange Online |
-Everyone
El modificador Todos especifica que la directiva se aplica a todos los usuarios de la organización. No es necesario especificar un valor con este modificador.
No use este modificador con los parámetros GroupIds o UserIds.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
| Se aplica a: | Exchange Online |
-FeatureId
El parámetro FeatureId especifica la característica en el módulo de Viva para el que desea agregar la directiva.
Para ver detalles sobre las características de un módulo de Viva que admiten controles de acceso a características, use el cmdlet Get-VivaModuleFeature. El valor featureid se devuelve en la salida del cmdlet.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
| Se aplica a: | Exchange Online |
-GroupIds
El parámetro GroupIds especifica las direcciones de correo electrónico o los identificadores de objeto de grupo de seguridad (GUID) de los grupos a los que se aplica la directiva actualizada. Se admiten grupos de Microsoft Entra habilitados para correo y no habilitados para correo. Update
Puede especificar un máximo de 20 usuarios o grupos totales (20 usuarios y ningún grupo, 10 usuarios y 10 grupos, etc.).
Para que la directiva se aplique a todos los usuarios de la organización, use el modificador Todos.
Nota: En v3.5.1-Preview2 o posterior del módulo, este parámetro admite identificadores de objeto de grupo de seguridad (GUID). Las versiones anteriores del módulo solo aceptan direcciones de correo electrónico para este parámetro.
| Tipo: | String[] |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
| Se aplica a: | Exchange Online |
-IsCategoryEnabled
Este parámetro está disponible en la versión 3.5.0-Preview2 o posterior del módulo.
Nota: Actualmente, no hay categorías disponibles en Viva. Actualizaremos la documentación cuando haya categorías disponibles.
El parámetro IsCategoryEnabled especifica si la directiva habilita o no la categoría. Los valores admitidos son:
- $true: la directiva habilita la categoría.
- $false: la directiva no habilita la categoría.
| Tipo: | Boolean |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
| Se aplica a: | Exchange Online |
-IsFeatureEnabled
El parámetro IsFeatureEnabled especifica si la directiva habilita o no la característica. Los valores admitidos son:
- $true: la directiva habilita la característica.
- $false: la directiva no habilita la característica.
| Tipo: | Boolean |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
| Se aplica a: | Exchange Online |
-IsUserControlEnabled
Este parámetro está disponible en la versión 3.3.0 o posterior del módulo.
El parámetro IsUserControlEnabled especifica si la directiva habilita el control de usuario. Los valores admitidos son:
- $true: la directiva habilita el control de usuario. Los usuarios pueden optar por no participar en la característica.
- $false: la directiva no habilita el control de usuario. Los usuarios no pueden optar por la característica.
Solo las características que permiten a los administradores habilitar y deshabilitar controles de usuario por directiva pueden usar este parámetro. Si la característica no admite la alternancia de controles de usuario por parte de los administradores, se aplica el valor predeterminado. Consulte la documentación de características para obtener más información.
| Tipo: | Boolean |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
| Se aplica a: | Exchange Online |
-ModuleId
El parámetro ModuleId especifica el módulo Viva para el que desea agregar la directiva de características.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
| Se aplica a: | Exchange Online |
-Name
El parámetro Name especifica el nombre de la directiva. La longitud máxima es de 256 caracteres. Si el valor contiene espacios, escriba el valor entre comillas (").
Los caracteres válidos son letras inglesas, números, comas, puntos y espacios.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
| Se aplica a: | Exchange Online |
-ResultSize
Este parámetro está reservado para uso interno de Microsoft.
| Tipo: | Unlimited |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
| Se aplica a: | Exchange Online |
-UserIds
El parámetro UserIds especifica los nombres principales de usuario (UPN) de los usuarios a los que se aplica la directiva. Update
Puede especificar un máximo de 20 usuarios o grupos totales (20 usuarios y ningún grupo, 10 usuarios y 10 grupos, etc.).
Para que la directiva se aplique a todos los usuarios de la organización, use el modificador Todos.
| Tipo: | String[] |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
| Se aplica a: | Exchange Online |
-WhatIf
El modificador WhatIf simula las acciones del comando. Puede usar este modificador para ver los cambios que se producirían, pero sin aplicar los cambios. No es necesario especificar un valor con este modificador.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
| Se aplica a: | Exchange Online |