Add-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 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 distintos parámetros del cmdlet. Las directivas se usan para restringir o conceder acceso a la característica especificada para usuarios, grupos o todo el inquilino específicos. Tenga en cuenta que 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

Add-VivaModuleFeaturePolicy
   -FeatureId <String>
   -IsFeatureEnabled <Boolean>
   -ModuleId <String>
   -Name <String>
   [-Confirm]
   [-GroupIds <String[]>]
   [-UserIds <String[]>]
   [-Everyone]
   [-ResultSize <Unlimited>]
   [-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 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

Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name DisableFeatureForAll -IsFeatureEnabled $false -Everyone

En este ejemplo se agrega una directiva para la característica 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

En este ejemplo se agrega una directiva para la característica 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 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 -UserIds user1@contoso.com,user2@contoso.com

En este ejemplo se agrega una directiva para la característica Reflexión en Viva Insights. La directiva deshabilita la característica para los usuarios y miembros del grupo especificados.

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 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.

Type:SwitchParameter
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 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 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 SMTP (direcciones de correo electrónico) de los grupos a los que se aplica la directiva. Se admiten grupos de AAD habilitados para correo. Update

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 se aplique a todos los usuarios de la organización, use el modificador Todos.

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 habilita o no la característica. Los valores admitidos son:

  • $true: la directiva habilita la característica.
  • $false: la directiva no habilita la característica.
Type:Boolean
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ModuleId

El parámetro ModuleId especifica el módulo Viva para el que desea agregar la directiva de características.

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 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.

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. Update

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 se aplique a todos los usuarios de la organización, use el modificador Todos.

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