Update-VivaModuleFeaturePolicy
Este cmdlet solo está disponible en la versión 3.2.0 o posterior del módulo de PowerShell Exchange Online. Para obtener más información, vea Acerca de la Exchange Online módulo de PowerShell.
Use el cmdlet Update-VivaModuleFeaturePolicy para actualizar una directiva de acceso para una característica de un módulo de Viva en Viva.
- No se puede actualizar una directiva para que un usuario o grupo determinado incluya 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 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
Default (Es el 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 de Viva en Viva.
Este cmdlet actualiza los atributos de la directiva que especifique. Estos atributos incluyen:
- Nombre de la directiva (parámetro Name).
- Si la directiva habilita o no la característica (parámetro IsFeatureEnabled).
- 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 Everyone).
Puede actualizar estos atributos de forma independiente entre sí. Por ejemplo, si especifica el parámetro Name pero no el parámetro IsFeatureEnabled, el nombre de la directiva se actualiza, pero si la directiva habilita la característica permanece o no sin cambios.
Importante: Los valores que especifique para los parámetros UserIds o GroupIds o el parámetro Everyone sobrescriben los usuarios o grupos existentes. Para conservar los usuarios y grupos existentes, debe especificar los usuarios o grupos existentes y los usuarios o grupos adicionales que quiera agregar. Al no incluir usuarios o grupos existentes en el comando, se quitan de la directiva esos usuarios o grupos específicos. 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 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 aboga firmemente por el principio de privilegios mínimos. La asignación de 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. Administrador global es un rol con privilegios elevados que normalmente se limita a escenarios de emergencia o cuando no se puede usar un rol diferente.
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 para 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 se aplica la directiva.
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 se aplica la directiva.
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 hace para 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 aplica la directiva.
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 que se agregaron anteriormente a la directiva, permite controles de usuario y desactivó a los usuarios de forma predeterminada (directiva de deshabilitación temporal).
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 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.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | 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 Everyone 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 del parámetro
| Tipo: | Boolean |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | 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 en el módulo Viva de la directiva que desea actualizar.
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.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | 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 a los grupos existentes. Para conservar los grupos existentes, insclúyelos junto con los nuevos usuarios o grupos que especifique.
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 actualizada se aplique a todos los usuarios de la organización, use el parámetro Everyone con el valor $true.
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.
Propiedades del parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | 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 directiva habilita la característica.
- $false: la directiva no habilita la característica.
Si no desea actualizar si la directiva habilita la característica, no use este parámetro.
Propiedades del parámetro
| Tipo: | Boolean |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | 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 el módulo versión 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 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.
Si no desea actualizar si la directiva habilita el control de usuario, no use este parámetro.
Propiedades del parámetro
| Tipo: | Boolean |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | 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 el módulo versión 3.8.0-Preview2 o posterior.
El parámetro IsUserOptedInByDefault especifica si la directiva participa 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 no permite que los usuarios no puedan hacerlo 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 se establece en $true.
Propiedades del parámetro
| Tipo: | Boolean |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | 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 del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | 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 desea actualizar el nombre de la directiva, no use este parámetro.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | 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 de la característica en el módulo de Viva que desea actualizar.
Para ver detalles sobre las directivas de una característica en un módulo de Viva, use el cmdlet Get-VivaModuleFeaturePolicy . El valor de PolicyId se devuelve en la salida del cmdlet.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | 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 del parámetro
| Tipo: | Unlimited |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | 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, insclúyelos junto con los nuevos usuarios o grupos que especifique.
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 actualizada se aplique a todos los usuarios de la organización, use el parámetro Everyone con el valor $true.
Propiedades del parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | 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 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.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | 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.