Add-VivaModuleFeaturePolicy
Este cmdlet solo está disponible en la versión 3.2.0 o posterior del módulo PowerShell de Exchange Online. Para obtener más información, consulte Acerca del módulo de PowerShell de Exchange Online.
Use el cmdlet Add-VivaModuleFeaturePolicy para agregar una nueva directiva de acceso para una característica específica en Viva. Los atributos de la directiva se definen mediante los parámetros cmdlet. Las directivas se usan para restringir u conceder acceso a la característica especificada a usuarios específicos, grupos o a todo el inquilino.
- Puede asignar hasta 10 directivas por característica. Se puede asignar una directiva adicional por característica 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 está habilitada. Si un usuario tiene varias directivas asignadas para una característica (directamente como usuario o miembro de un grupo), se aplica la directiva más restrictiva.
- 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 de controles de usuario (opción de no participación del usuario). Consulte la documentación de características para ver si hay controles de usuario 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
Default (valor predeterminado)
Add-VivaModuleFeaturePolicy
-FeatureId <String>
-IsFeatureEnabled <Boolean>
-ModuleId <String>
-Name <String>
[-Confirm]
[-Everyone]
[-GroupIds <String[]>]
[-IsUserControlEnabled <Boolean>]
[-IsUserOptedInByDefault <Boolean>]
[-ResultSize <Unlimited>]
[-UserIds <String[]>]
[-WhatIf]
[<CommonParameters>]
Description
Use el cmdlet Add-VivaModuleFeaturePolicy para agregar una nueva directiva de acceso para una característica específica en Viva.
Debe usar el cmdlet Connect-ExchangeOnline para autenticarse.
Este cmdlet requiere .NET Framework 4.7.2 o posterior.
Actualmente, debe ser miembro del rol de 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 del acceso a características.
Para obtener más información sobre los permisos de rol de administrador en Microsoft Entra ID, consulte ID de plantilla de rol.
Importante
Microsoft promueve encarecidamente el principio de privilegios mínimos. Asignar a las cuentas solo los permisos mínimos necesarios para realizar sus tareas ayuda a reducir los riesgos de seguridad y refuerza la protección general de la organización. El administrador global es un rol con privilegios elevados que normalmente se limita a escenarios de emergencia o cuando no se puede usar otro rol.
Ejemplos
Ejemplo 1
Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name DisableFeatureForAll -IsFeatureEnabled $false -Everyone
En este ejemplo se agrega una directiva para la característica de 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-f72095d4e9c3
En este ejemplo se agrega una directiva para la característica de 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.com
En este ejemplo se agrega una directiva para la característica de 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.com
En este ejemplo se agrega una directiva para la característica de reflexión en Viva Insights. La directiva deshabilita la característica para los usuarios y miembros del grupo especificados.
Ejemplo 5
Add-VivaModuleFeaturePolicy -ModuleId PeopleSkills -FeatureId ShowAISkills -Name SoftDisableShowAISkillsPolicy -IsFeatureEnabled $true -IsUserControlEnabled $true -IsUserOptedInByDefault $false -UserIds user1@contoso.com,user2@contoso.com
En este ejemplo se agrega una directiva para la característica ShowAISkills en Viva Skills. La directiva habilita la característica para los usuarios especificados, permite controles de usuario y excluye a los usuarios de forma predeterminada (directiva de deshabilitación parcial).
Parámetros
-Confirm
Aplicable: Exchange Online
El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador al 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. Para estos cmdlets, especificar el modificador Confirm sin un valor introduce una pausa que le obliga a reconocer el comando antes de continuar.
Este cmdlet tiene una pausa integrada, así que úselo -Confirm:$false para omitir la confirmación.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Everyone
Aplicable: Exchange Online
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.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-FeatureId
Aplicable: Exchange Online
El parámetro FeatureId especifica la característica del módulo Viva para la que desea agregar la directiva.
Para ver detalles sobre las características de un módulo Viva que admiten controles de acceso a funciones, use el Get-VivaModuleFeature cmdlet. El valor de FeatureId se devuelve en la salida del cmdlet.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-GroupIds
Aplicable: Exchange Online
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 en total (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 conmutador Todos.
Nota: En la versión 3.5.1-Preview2 o posterior del módulo, este parámetro admite identificadores de objeto (GUID) de grupo de seguridad. Las versiones anteriores del módulo solo aceptan direcciones de correo electrónico para este parámetro.
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-IsFeatureEnabled
Aplicable: Exchange Online
El parámetro IsFeatureEnabled especifica si la directiva habilita o no la característica. Los valores admitidos son:
- $true: la característica está habilitada por la directiva.
- $false: la característica no está habilitada por la directiva.
Propiedades de parámetro
| Tipo: | Boolean |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-IsUserControlEnabled
Aplicable: Exchange Online
Nota: Este parámetro está disponible en la versión del módulo 3.3.0-Preview1 o posterior.
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 dejar de participar en la característica.
- $false: la directiva no habilita el control de usuario. Los usuarios no pueden optar por la característica.
Solo pueden usar este parámetro las características que permiten a los administradores habilitar y deshabilitar los controles de usuario por directiva. Si la característica no admite que los administradores puedan alternar los controles de usuario, se aplica el valor predeterminado. Consulte la documentación de características para obtener más información.
Propiedades de parámetro
| Tipo: | Boolean |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-IsUserOptedInByDefault
Aplicable: Exchange Online
Nota: Este parámetro está disponible en la versión del módulo 3.8.0-Preview2 o posterior.
El parámetro IsUserOptedInByDefault especifica si la directiva está participando de forma predeterminada en los usuarios. Los valores admitidos son:
- $true: de forma predeterminada, la directiva opta por los usuarios si el usuario no ha establecido una preferencia.
- $false: De forma predeterminada, la directiva excluye a los usuarios si el usuario no ha establecido una preferencia.
Este parámetro es opcional y se puede usar para invalidar el valor predeterminado de participación del usuario establecido en los metadatos de la característica.
Este parámetro solo se puede establecer cuando el parámetro IsUserControlEnabled está establecido en $true.
Propiedades de parámetro
| Tipo: | Boolean |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ModuleId
Aplicable: Exchange Online
El parámetro ModuleId especifica el módulo Viva al que desea agregar la directiva de características.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Name
Aplicable: Exchange Online
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.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ResultSize
Aplicable: Exchange Online
Este parámetro está reservado para uso interno de Microsoft.
Propiedades de parámetro
| Tipo: | Unlimited |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-UserIds
Aplicable: Exchange Online
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 en total (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 conmutador Todos.
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-WhatIf
Aplicable: Exchange Online
El modificador WhatIf muestra lo que hace el comando sin realizar ningún cambio. No es necesario especificar un valor con este modificador.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.