Update-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 Update-VivaModuleFeaturePolicy para actualizar una directiva de acceso para una característica de un módulo Viva en Viva.
- No se puede actualizar una directiva para un usuario o grupo determinado para incluir todo el inquilino si ya existe una directiva para todo el inquilino para la característica. Solo se admite una directiva para 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)
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
Use el cmdlet Update-VivaModuleFeaturePolicy para actualizar una directiva de acceso para una característica de un módulo Viva en Viva.
Este cmdlet actualiza los atributos de la directiva que especifique. Estos atributos incluyen:
- El nombre de la directiva (parámetro Name).
- Independientemente de si la directiva habilita o no la característica (parámetro IsFeatureEnabled).
- Indica si la directiva habilita o no controles de usuario (parámetro IsUserControlEnabled, solo aplicable a una directiva de características).
- A quién se aplica la directiva (los parámetros UserIds y GroupIds o el parámetro Todos).
Estos atributos se pueden actualizar independientemente unos de otros. Por ejemplo, si especifica el parámetro Name pero no el parámetro IsFeatureEnabled, el nombre de la directiva se actualiza, pero la característica permanece sin cambiar independientemente de si la directiva habilita la opción.
Importante: Los valores que especifique para los parámetros UserIds y/o GroupIds o el parámetro Everyone sobrescriben cualquier usuario o grupo existente. Para conservar los usuarios y grupos existentes, debe especificar esos usuarios o grupos existentes y cualquier usuario o grupo adicional que desee agregar. Si no se incluyen los usuarios o grupos existentes en el comando, se quitan de forma eficaz esos usuarios o grupos específicos de la directiva. Para obtener más información, consulte los ejemplos.
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
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b1 -Name NewPolicyName -IsFeatureEnabled $false
En este ejemplo se actualiza el nombre de la directiva especificada y se hace que la directiva no habilite la característica.
Ejemplo 2
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -GroupIds group1@contoso.com,group2@contoso.com
En este ejemplo se actualiza a quién se aplica la directiva especificada. La directiva ahora solo se aplica a los grupos especificados, sobrescribiendo los usuarios y grupos a los que solía aplicarse.
Ejemplo 3
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -UserIds user1@contoso.com,user2@contoso.com
En este ejemplo se actualiza a quién se aplica la directiva especificada. La directiva ahora solo se aplica a los usuarios especificados, sobrescribiendo los usuarios y grupos a los que solía aplicarse.
Ejemplo 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
En este ejemplo se actualiza el nombre de la directiva especificada, se permite que la directiva habilite la característica y se actualiza a quién se aplica la directiva. La directiva ahora solo se aplica a los usuarios y grupos especificados, sobrescribiendo los usuarios y grupos a los que se solía aplicar.
Ejemplo 5
Update-VivaModuleFeaturePolicy -ModuleId PeopleSkills -FeatureId ShowAISkills -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -IsFeatureEnabled $true -IsUserControlEnabled $true -IsUserOptedInByDefault $false
En este ejemplo se actualiza una directiva para la característica ShowAISkills en Viva Skills. La directiva habilita la característica para los usuarios agregados previamente a la directiva, 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.
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 parámetro Todos especifica que la directiva actualizada se aplica a todos los usuarios de la organización. Los valores admitidos son:
- $true: la directiva se aplica a todos los usuarios. Este es el único valor útil para este parámetro.
- $false: No use este valor.
Si no desea actualizar a quién se aplica la directiva, no use este parámetro.
No use este parámetro con los parámetros GroupIds o UserIds.
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 |
-FeatureId
Aplicable: Exchange Online
El parámetro FeatureId especifica la característica del módulo Viva de la directiva que desea actualizar.
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
Si no desea actualizar a quién se aplica la directiva, no use este parámetro.
Los valores que especifique para este parámetro o el parámetro UserIds reemplazan los grupos existentes. Para conservar los grupos existentes, inclúyalos junto con los nuevos usuarios o grupos que especifique.
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 actualizada se aplique a todos los usuarios de la organización, use el parámetro Todos con el valor $true.
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 actualizada habilita 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.
Si no desea actualizar si la característica está habilitada por la directiva, no use este parámetro.
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 |
-IsUserControlEnabled
Aplicable: Exchange Online
Nota: Este parámetro está disponible en la versión del módulo 3.3.0-Preview1 o posterior. Si la característica admite controles de usuario para no participar, asegúrese de establecer el parámetro IsUserControlEnabled al crear la directiva. De lo contrario, los controles de usuario de la directiva usan el estado predeterminado para la característica.
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.
Si no desea actualizar si la directiva habilita el control de usuario, no use este parámetro.
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 de la directiva que desea actualizar.
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 actualizado 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.
Si no quiere actualizar el nombre de la directiva, no use 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 |
-PolicyId
Aplicable: Exchange Online
El parámetro PolicyId especifica la directiva para la característica del módulo Viva que desea actualizar.
Para ver los detalles sobre las directivas de una característica de un módulo Viva, utilice el Get-VivaModuleFeaturePolicy cmdlet. El valor PolicyId 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 |
-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 actualizada. Update
Si no desea actualizar a quién se aplica la directiva, no use este parámetro.
Los valores que especifique para este parámetro o el parámetro GroupIds reemplazan a los usuarios existentes. Para conservar los usuarios existentes, inclúyalos junto con los nuevos usuarios o grupos que especifique.
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 actualizada se aplique a todos los usuarios de la organización, use el parámetro Todos con el valor $true.
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.