Update-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: Este cmdlet forma parte de una característica que se encuentra actualmente en una versión preliminar privada cerrada. El cmdlet no funcionará a menos que su organización sea miembro de la versión preliminar privada.
Use el cmdlet Update-VivaModuleFeaturePolicy para actualizar una directiva de acceso para una característica en un módulo Viva. La directiva más restrictiva para un usuario o grupo determinado tiene prioridad al determinar si una característica está habilitada.
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.
Syntax
Update-VivaModuleFeaturePolicy
-FeatureId <String>
-ModuleId <String>
-PolicyId <String>
[-Confirm]
[-IsFeatureEnabled <Boolean>]
[-GroupIds <String[]>]
[-Everyone <Boolean>]
[-Name <String>]
[-ResultSize <Unlimited>]
[-UserIds <String[]>]
[-WhatIf]
[<CommonParameters>]
Description
Use el cmdlet Update-VivaModuleFeaturePolicy para actualizar una directiva de acceso para una característica en un módulo 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).
- 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 para ejecutar este cmdlet.
Para más información sobre los permisos de rol de administrador en Azure Active Directory, consulte Identificadores de plantilla de 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 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 -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.
Parámetros
-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, 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 demás cmdlets (por ejemplo, los cmdlets 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.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-Everyone
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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-FeatureId
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 Viva que admiten controles de acceso a características, use el cmdlet Get-VivaModuleFeature. El valor featureid se devuelve en la salida del cmdlet.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-GroupIds
El parámetro GroupIds especifica las direcciones de correo electrónico de los grupos a los que se aplica la directiva actualizada. Se admiten grupos de AAD 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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-IsFeatureEnabled
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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-ModuleId
El parámetro ModuleId especifica el módulo Viva de la directiva que desea actualizar.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-Name
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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-PolicyId
El parámetro PolicyId especifica la directiva de la característica en el módulo Viva que desea actualizar.
Para ver detalles sobre las directivas de una característica en un módulo Viva, use el cmdlet Get-VivaModuleFeaturePolicy. El valor de PolicyId se devuelve en la salida del cmdlet.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-ResultSize
Este parámetro está reservado para uso interno de Microsoft.
Type: | Unlimited |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-UserIds
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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | 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.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |