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