Get-VivaModuleFeaturePolicy
Cette applet de commande est disponible uniquement dans le module PowerShell d’Exchange Online version 3.2.0 ou ultérieure. Pour plus d’informations, consultez À propos du module Exchange Online PowerShell.
Utilisez l’applet de commande Get-VivaModuleFeaturePolicy pour afficher les stratégies d’accès d’une fonctionnalité spécifiée dans un module Viva dans Viva. Les stratégies sont utilisées pour restreindre ou accorder l’accès à la fonctionnalité spécifiée pour des utilisateurs, des groupes ou l’ensemble du client spécifiques. Cette applet de commande fournit des détails sur les stratégies, notamment l’identificateur de la stratégie, son nom et sa date de création. L’applet de commande peut filtrer les stratégies en fonction des MemberIds, ce qui permet aux administrateurs d’afficher les stratégies spécifiques à certains utilisateurs ou groupes.
Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.
Syntaxe
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
Utilisez l’applet de commande Get-VivaModuleFeaturePolicy pour afficher les stratégies d’accès d’une fonctionnalité spécifiée dans un module Viva dans Viva.
Vous pouvez afficher toutes les stratégies pour une fonctionnalité spécifiée dans un module Viva de Viva. Pour afficher une stratégie spécifique, vous pouvez inclure le paramètre PolicyId.
L’applet de commande peut filtrer les stratégies en fonction des MemberIds, ce qui permet aux administrateurs d’afficher les stratégies spécifiques à certains utilisateurs ou groupes.
Vous devez utiliser l’applet de commande Connect-ExchangeOnline pour vous authentifier.
Cette applet de commande nécessite .NET Framework 4.7.2 ou version ultérieure.
Actuellement, vous devez être membre du rôle d’administrateur général ou des rôles qui ont été attribués au niveau de la fonctionnalité pour exécuter cette applet de commande.
Pour en savoir plus sur les rôles attribués au niveau des fonctionnalités, consultez Fonctionnalités disponibles pour la gestion de l’accès aux fonctionnalités.
Pour en savoir plus sur les autorisations de rôle d’administrateur dans Microsoft Entra ID, consultez ID de modèle de rôle.
Importante
Microsoft défend fermement le principe du moindre privilège. Le fait de ne donner aux comptes que les autorisations minimales nécessaires à l’exécution de leurs tâches permet de réduire les risques de sécurité et de renforcer la protection globale de votre organisation. Le rôle Administrateur général est un rôle hautement privilégié que vous limitez généralement aux scénarios d’urgence ou lorsque vous ne pouvez pas utiliser un autre rôle.
Exemples
Exemple 1
Get-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection
Cet exemple renvoie des détails sur toutes les stratégies ajoutées pour la fonctionnalité Reflection dans Viva Insights.
Exemple 2
Get-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b
Cet exemple renvoie les détails d’une stratégie spécifique ajoutée pour la fonctionnalité Reflection dans Viva Insights.
Exemple 3
Get-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -MemberIds user1@contoso.com
Cet exemple retourne des détails sur les stratégies de la fonctionnalité Réflexion dans Viva Insights qui s’appliquent à l’utilisateur avec l’e-mail user1@contoso.com.
Exemple 4
Get-VivaModuleFeaturePolicy -ModuleId * -FeatureId * -MemberIds user1@contoso.com,group1@contoso.com
Cet exemple retourne des détails sur les stratégies de toutes les fonctionnalités de tous les modules Viva qui s’appliquent à l’utilisateur avec l’e-mail et au groupe avec l’e-mail user1@contoso.comgroup1@contoso.com.
Paramètres
-FeatureId
Applicable : Exchange Online
Le paramètre FeatureId spécifie la fonctionnalité du module Viva pour laquelle vous souhaitez afficher les stratégies.
Pour afficher les détails des fonctionnalités d’un module Viva qui prennent en charge les contrôles d’accès aux fonctionnalités, reportez-vous à l’applet de commande Get-VivaModuleFeature. Les détails fournis par l’applet de commande Get-VivaModuleFeature incluent l’identificateur de la fonctionnalité.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
FeaturePolicy
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
FeaturePolicyWithMembers
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-MemberIds
Applicable : Exchange Online
Remarque : ce paramètre est disponible dans la version de module 3.8.1-Preview1 ou ultérieure.
Le paramètre MemberIds spécifie les utilisateurs ou groupes spécifiques pour lesquels vous souhaitez afficher les stratégies de la fonctionnalité dans le module Viva.
Vous pouvez fournir jusqu’à trois ID de membre. Utilisez le caractère * pour spécifier tous les modules ou fonctionnalités.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
FeaturePolicyWithMembers
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ModuleId
Applicable : Exchange Online
Le paramètre ModuleId spécifie le module Viva des stratégies de fonctionnalité que vous souhaitez afficher.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-PolicyId
Applicable : Exchange Online
Le paramètre PolicyId spécifie la stratégie spécifique de la fonctionnalité du module Viva que vous souhaitez afficher.
Pour afficher les détails de toutes les stratégies d’une fonctionnalité d’un module Viva, exécutez cette applet de commande sans le paramètre PolicyId. Ces détails incluent les identificateurs de toutes les stratégies pour une fonctionnalité dans un module Viva.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
FeaturePolicy
| Position: | Positional |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ResultSize
Applicable : Exchange Online
Ce paramètre est réservé à l’usage interne chez Microsoft.
Propriétés du paramètre
| Type: | Microsoft.Exchange.Management.RestApiClient.Unlimited`1[System.UInt32] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.