Get-VivaModuleFeaturePolicy
Cette applet de commande est disponible uniquement dans le module PowerShell Exchange Online version 3.2.0 ou ultérieure. Pour plus d’informations, consultez À propos du module PowerShell Exchange Online.
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 locataire. Cette applet de commande fournit des détails sur les stratégies, notamment l’identificateur, le nom et la date de création de la stratégie. 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 d’une fonctionnalité spécifiée dans un module Viva dans 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 Administrateurs généraux 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 de la fonctionnalité, 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 des privilèges minimum. L’attribution de comptes uniquement les autorisations minimales nécessaires à l’exécution de leurs tâches permet de réduire les risques de sécurité et renforce la protection globale de votre organization. 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 retourne des détails sur toutes les stratégies ajoutées pour la fonctionnalité Réflexion dans Viva Insights.
Exemple 2
Get-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b
Cet exemple retourne des détails sur une stratégie spécifique ajoutée pour la fonctionnalité réflexion 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 user1@contoso.com et au groupe avec l’e-mail group1@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 des détails sur les 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 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 le module version 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 pour la fonctionnalité dans le module Viva que vous souhaitez afficher.
Pour afficher les détails de toutes les stratégies d’une fonctionnalité dans 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 d’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 courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.