Get-VivaModuleFeaturePolicy
Este cmdlet solo está disponible en la versión 3.2.0 o posterior del módulo PowerShell de Exchange Online. Para obtener más información, consulte Acerca del módulo de PowerShell de Exchange Online.
Use el cmdlet Get-VivaModuleFeaturePolicy para ver las directivas de acceso de una característica especificada en un módulo Viva. Las directivas se usan para restringir u conceder acceso a la característica especificada a usuarios específicos, grupos o a todo el inquilino. Este cmdlet proporciona detalles sobre las directivas, incluido el identificador de las directivas, el nombre y la fecha de creación. El cmdlet puede filtrar directivas en función de MemberIds, lo que permite a los administradores ver directivas específicas para determinados usuarios o grupos.
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
FeaturePolicy
Get-VivaModuleFeaturePolicy
[[-PolicyId] <String>]
-FeatureId <String>
-ModuleId <String>
[-ResultSize <Unlimited>]
[<CommonParameters>]
FeaturePolicyWithMembers
Get-VivaModuleFeaturePolicy
[[-FeatureId] <String>]
[[-MemberIds] <String[]>]
-ModuleId <String>
[-ResultSize <Unlimited>]
[<CommonParameters>]
Description
Use el cmdlet Get-VivaModuleFeaturePolicy para ver las directivas de acceso de una característica especificada en un módulo Viva.
Puede ver todas las directivas de una característica específica en un módulo Viva en Viva. Para ver una directiva específica, puede incluir el parámetro PolicyId.
El cmdlet puede filtrar directivas en función de MemberIds, lo que permite a los administradores ver directivas específicas para determinados usuarios o grupos.
Debe usar el cmdlet Connect-ExchangeOnline para autenticarse.
Este cmdlet requiere .NET Framework 4.7.2 o posterior.
Actualmente, debe ser miembro del rol de administradores globales o de los roles que se han asignado en el nivel de característica para ejecutar este cmdlet.
Para obtener más información sobre los roles asignados en el nivel de característica, consulte Características disponibles para la administración del acceso a características.
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-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection
En este ejemplo se devuelven detalles sobre todas las directivas agregadas para la característica Reflexión en Viva Insights.
Ejemplo 2
Get-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b
En este ejemplo se devuelven detalles sobre una directiva específica agregada para la característica Reflexión en Viva Insights.
Ejemplo 3
Get-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -MemberIds user1@contoso.com
En este ejemplo se devuelven detalles sobre las directivas para la característica de reflexión en Viva Insights que se aplican al usuario con el correo electrónico user1@contoso.com.
Ejemplo 4
Get-VivaModuleFeaturePolicy -ModuleId * -FeatureId * -MemberIds user1@contoso.com,group1@contoso.com
En este ejemplo se devuelven detalles sobre las directivas de todas las características de todos los módulos Viva que se aplican al usuario con el correo electrónico user1@contoso.com y al grupo con el correo electrónico group1@contoso.com.
Parámetros
-FeatureId
Aplicable: Exchange Online
El parámetro FeatureId especifica la característica del módulo Viva para la que desea ver las directivas.
Para ver los detalles sobre las características de un módulo Viva que admiten controles de acceso a funciones, consulte el cmdlet Get-VivaModuleFeature. Los detalles proporcionados por el cmdlet de Get-VivaModuleFeature incluyen el identificador de la característica.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
FeaturePolicy
| 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 |
FeaturePolicyWithMembers
| 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 |
-MemberIds
Aplicable: Exchange Online
Nota: Este parámetro está disponible en la versión del módulo 3.8.1-Preview1 o posterior.
El parámetro MemberIds especifica los usuarios o grupos específicos para los que desea ver las directivas de la función en el módulo Viva.
Puede proporcionar hasta tres identificaciones de miembro. Use el carácter * para especificar todos los módulos o características.
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
FeaturePolicyWithMembers
| 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 |
-ModuleId
Aplicable: Exchange Online
El parámetro ModuleId especifica el módulo Viva de las directivas de características que desea ver.
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 |
-PolicyId
Aplicable: Exchange Online
El parámetro PolicyId especifica la directiva específica para la característica en el módulo Viva que desea ver.
Para ver detalles sobre todas las directivas de una característica de un módulo Viva, ejecute este cmdlet sin el parámetro PolicyId. Estos detalles incluyen los identificadores de todas las directivas de una característica de un módulo Viva.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
FeaturePolicy
| Posición: | Positional |
| Obligatorio: | False |
| 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: | Microsoft.Exchange.Management.RestApiClient.Unlimited`1[System.UInt32] |
| 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.