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