Get-VivaModuleFeatureEnablement
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 Get-VivaModuleFeatureEnablement para ver si una característica de un módulo Viva está habilitada para un usuario o grupo específico. Si la característica está habilitada o no se conoce como "estado de habilitación" de la característica. El estado de habilitación devuelto por este cmdlet se basa en las directivas de acceso establecidas por el administrador.
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 (valor predeterminado)
Get-VivaModuleFeatureEnablement
-FeatureId <String>
-Identity <String>
-ModuleId <String>
[-Detailed]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Description
Use el cmdlet Get-VivaModuleFeatureEnablement para ver si una característica de un módulo Viva está habilitada para un usuario o grupo específico.
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 obtener más información sobre los permisos de rol de administrador en Microsoft Entra ID, consulte Identificadores de plantilla de rol.
Importante
Microsoft promueve encarecidamente el principio de privilegios mínimos. Asignar a las 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
Get-VivaModuleFeatureEnablement -ModuleId VivaInsights -FeatureId Reflection -Identity user@contoso.com
En este ejemplo se devuelve el estado de habilitación de la característica Reflexión en Viva Insights para el user@contoso.com usuario.
Ejemplo 2
Get-VivaModuleFeatureEnablement -ModuleId VivaInsights -FeatureId Reflection -Identity group@contoso.com
En este ejemplo se devuelve el estado de habilitación de la característica Reflexión en Viva Insights para el group@contoso.com grupo.
Ejemplo 3
Get-VivaModuleFeatureEnablement -ModuleId VivaInsights -FeatureId Reflection -Identity user@contoso.com -Detailed
En este ejemplo se devuelve el estado de habilitación de la característica Reflexión en Viva Insights para el user@contoso.com usuario. La respuesta se ha mejorado para proporcionar información adicional sobre las directivas que impulsan el estado de habilitación de la característica.
Parámetros
-Detailed
Aplicable: Exchange Online
Nota: Este parámetro está disponible en la versión 3.8.1-Preview1 del módulo o posterior.
El modificador Detallado mejora la salida del comando proporcionando información más completa. No es necesario especificar un valor con este modificador.
Este modificador devuelve información detallada, incluidas las directivas relacionadas y su eficacia.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | 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.
Para ver detalles sobre las características de un módulo Viva que admiten controles de acceso a características, consulte el cmdlet Get-VivaModuleFeature. Los detalles proporcionados por el cmdlet Get-VivaModuleFeature incluyen el identificador de característica.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Identity
Aplicable: Exchange Online
El parámetro Identity especifica el nombre principal de usuario (UPN) del usuario o la dirección SMTP (dirección de correo electrónico) del grupo del que desea ver el estado de habilitación de características.
Se admiten grupos de Microsoft Entra habilitados para correo.
Precaución: El valor $null o un valor inexistente para el parámetro Identity devuelve todos los objetos como si ejecutara el comando Get- sin el parámetro Identity. Compruebe que las listas de valores del parámetro Identity son precisas y no contienen valores $null inexistentes.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | True |
| 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.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | 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 de parámetro
| Tipo: | Unlimited |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | 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.