Get-VivaInsightsSettings
Este cmdlet solo está disponible en el módulo de PowerShell de Exchange Online. Para obtener más información, consulte Acerca del módulo de PowerShell de Exchange Online.
Nota: Este cmdlet solo está disponible en la versión 2.0.5 o posterior del módulo.
Use el cmdlet Get-VivaInsightsSettings para comprobar si un usuario tiene acceso a las características de Microsoft Viva Insights en Microsoft Teams. Solo los usuarios con buzones de Exchange Online aprovisionados pueden acceder a las características de la aplicación Viva Insights en Teams.
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-VivaInsightsSettings
-Identity <String>
[-Feature <String>]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Description
Este cmdlet requiere .NET Framework 4.7.2 o posterior.
Para ejecutar este cmdlet, debe ser miembro de uno de los siguientes grupos de roles de directorio en la organización de destino:
- Administrador global
- Administrador de Exchange
- Administrador de Teams
Para obtener más información sobre los permisos de rol de administrador en Microsoft Entra ID, consulte ID 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. El administrador global es un rol con privilegios elevados que normalmente se limita a escenarios de emergencia o cuando no se puede usar otro rol.
Ejemplos
Ejemplo 1
Get-VivaInsightsSettings -Identity roy@contoso.onmicrosoft.com
UserId : roy@contoso.onmicrosoft.com
IsInsightsHeadspaceEnabled : True
En este ejemplo se muestra la configuración de Microsoft Viva Insights en Microsoft Teams para el usuarioroy@contoso.onmicrosoft.com. La salida del comando muestra que las funciones de Headspace están disponibles para Roy.
Parámetros
-Feature
Aplicable: Exchange Online
El parámetro Feature filtra los resultados por la característica especificada de Microsoft Viva Insights. Los valores admitidos son:
- Headspace: representa todas las características de Headspace.
- MeetingEffectivenessSurvey: este valor solo está disponible en la versión 2.0.6-Preview2 del módulo como parte de una versión preliminar privada.
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: | False |
| 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 usuario que desea ver. Identifica al usuario por su nombre principal de usuario (UPN) (por ejemplo, roy@contoso.onmicrosoft.com).
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 para el parámetro Identidad sean precisas y no contengan 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 |
-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.