Get-VivaModuleFeaturePolicy
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-VivaModuleFeaturePolicy para ver las directivas de acceso de una característica especificada en un módulo de Viva en Viva. Las directivas se usan para restringir o conceder acceso a la característica especificada para usuarios, grupos o todo el inquilino específicos. Este cmdlet proporciona detalles sobre las directivas, incluido el identificador, el nombre y la fecha de creación de la directiva. El cmdlet puede filtrar directivas basadas en MemberIds, lo que permite a los administradores ver directivas específicas de 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 de Viva en Viva.
Puede ver todas las directivas de una característica especificada en un módulo de Viva en Viva. Para ver una directiva específica, puede incluir el parámetro PolicyId.
El cmdlet puede filtrar directivas basadas en MemberIds, lo que permite a los administradores ver directivas específicas de 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 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 de acceso a características.
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 aboga firmemente por el principio de privilegios mínimos. La asignación de 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-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 de la característica reflexión de 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 el grupo con el correo electrónico group1@contoso.com.
Parámetros
-FeatureId
Aplicable: Exchange Online
El parámetro FeatureId especifica la característica en el módulo de Viva para el que desea ver las directivas.
Para ver detalles sobre las características de un módulo de 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 del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
FeaturePolicy
| Posición: | Named |
| Mandatory: | 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 |
| Mandatory: | 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 3.8.1-Preview1 del módulo o posterior.
El parámetro MemberIds especifica los usuarios o grupos específicos para los que desea ver las directivas de la característica en el módulo Viva.
Puede proporcionar hasta tres identificadores de miembro. Use el carácter * para especificar todos los módulos o características.
Propiedades del parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
FeaturePolicyWithMembers
| Posición: | Named |
| Mandatory: | 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 del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | 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 en un módulo de Viva, ejecute este cmdlet sin el parámetro PolicyId. Estos detalles incluyen los identificadores de todas las directivas de una característica en un módulo de Viva.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
FeaturePolicy
| Posición: | Positional |
| Mandatory: | 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 del 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 |
| Mandatory: | 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.