Add-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.
Remarque : la prise en charge des catégories est disponible dans la version 3.5.0-Preview2 ou ultérieure du module, mais aucune catégorie n’est actuellement disponible dans Viva. Nous allons mettre à jour la documentation lorsque des catégories sont disponibles.
Utilisez l’applet de commande Add-VivaModuleFeaturePolicy pour ajouter une nouvelle stratégie d’accès pour une fonctionnalité ou une catégorie spécifique dans Viva. Les attributs de la stratégie sont définis à l’aide des paramètres de l’applet de commande. Les stratégies sont utilisées pour restreindre ou accorder l’accès à la fonctionnalité ou à la catégorie spécifiée pour des utilisateurs, des groupes ou l’ensemble du locataire.
- Vous pouvez affecter jusqu’à 10 stratégies par fonctionnalité/catégorie. Une stratégie supplémentaire par fonctionnalité/catégorie peut être affectée à l’ensemble du locataire.
- Les stratégies affectées à un utilisateur ou à un groupe spécifique ont la priorité sur la stratégie affectée à l’ensemble du locataire lors de la détermination de l’activation d’une fonctionnalité ou d’une catégorie. Si un utilisateur a plusieurs stratégies attribuées pour une fonctionnalité/catégorie (directement en tant qu’utilisateur ou membre d’un groupe), la stratégie la plus restrictive s’applique.
- Si une catégorie est désactivée par des stratégies de catégorie, toutes les fonctionnalités de la catégorie sont désactivées, quelles que soient les stratégies définies au niveau de la fonctionnalité.
- Vous pouvez uniquement mettre à jour les contrôles utilisateur au niveau de la stratégie de fonctionnalité, et non au niveau de la stratégie de catégorie.
- Certaines fonctionnalités prennent uniquement en charge les stratégies qui s’appliquent à l’ensemble du locataire, et non à des utilisateurs ou des groupes spécifiques. Vous pouvez faire référence aux étendues de stratégie prises en charge pour une fonctionnalité à l’aide de l’applet de commande Get-VivaModuleFeature .
Certaines fonctionnalités incluent l’option pour les contrôles utilisateur (refus de l’utilisateur). Reportez-vous à la documentation des fonctionnalités pour voir si des contrôles utilisateur sont disponibles pour la fonctionnalité pour laquelle vous envisagez de définir une stratégie.
Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.
Syntaxe
Add-VivaModuleFeaturePolicy
-FeatureId <String>
-IsFeatureEnabled <Boolean>
-ModuleId <String>
-Name <String>
[-Confirm]
[-Everyone]
[-GroupIds <String[]>]
[-IsUserControlEnabled <Boolean>]
[-ResultSize <Unlimited>]
[-UserIds <String[]>]
[-WhatIf]
[<CommonParameters>] Add-VivaModuleFeaturePolicy
-CategoryId <String>
-IsCategoryEnabled <Boolean>
-Name <String>
[-Confirm]
[-Everyone]
[-GroupIds <String[]>]
[-ResultSize <Unlimited>]
[-UserIds <String[]>]
[-WhatIf]
[<CommonParameters>] Description
Utilisez l’applet de commande Add-VivaModuleFeaturePolicy pour ajouter une nouvelle stratégie d’accès pour une fonctionnalité ou une catégorie spécifique dans Viva.
La prise en charge des catégories est disponible dans la version 3.5.0-Preview2 ou ultérieure du module.
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 vous recommande d’utiliser des rôles disposant du moins d’autorisations. L’utilisation de comptes avec autorisation inférieure permet d’améliorer la sécurité de vos organization. Le rôle d’administrateur général dispose de privilèges élevés. Il doit être limité aux scénarios d’urgence lorsque vous ne pouvez pas utiliser un rôle existant.
Exemples
Exemple 1
Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name DisableFeatureForAll -IsFeatureEnabled $false -EveryoneCet exemple ajoute une stratégie pour la fonctionnalité Réflexion dans Viva Insights. La stratégie désactive la fonctionnalité pour tous les utilisateurs du organization.
Exemple 2
Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name MultipleGroups -IsFeatureEnabled $false -GroupIds group1@contoso.com,group2@contoso.com,57680382-61a5-4378-85ad-f72095d4e9c3Cet exemple ajoute une stratégie pour la fonctionnalité Réflexion dans Viva Insights. La stratégie désactive la fonctionnalité pour tous les utilisateurs des groupes spécifiés.
Exemple 3
Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name MultipleUsers -IsFeatureEnabled $false -UserIds user1@contoso.com,user2@contoso.comCet exemple ajoute une stratégie pour la fonctionnalité Réflexion dans Viva Insights. La stratégie désactive la fonctionnalité pour les utilisateurs spécifiés.
Exemple 4
Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name UsersAndGroups -IsFeatureEnabled $false -GroupIds group1@contoso.com,group2@contoso.com,57680382-61a5-4378-85ad-f72095d4e9c3 -UserIds user1@contoso.com,user2@contoso.comCet exemple ajoute une stratégie pour la fonctionnalité Réflexion dans Viva Insights. La stratégie désactive la fonctionnalité pour les utilisateurs et les membres du groupe spécifiés.
Exemple 5
Add-VivaModuleFeaturePolicy -CategoryId <category_id> -Name DisableCategoryForAll -IsCategoryEnabled $false -EveryoneCet exemple montre comment ajouter une stratégie pour la <category_id> catégorie dans Viva. La stratégie désactive la catégorie (en fait toutes les fonctionnalités de la catégorie) pour tous les utilisateurs du organization.
Exemple 6
Add-VivaModuleFeaturePolicy -CategoryId <category_id> -Name MultipleGroups -IsCategoryEnabled $false -GroupIds group1@contoso.com,group2@contoso.com,57680382-61a5-4378-85ad-f72095d4e9c3Cet exemple montre comment ajouter une stratégie pour la <category_id> catégorie dans Viva. La stratégie désactive la catégorie (en fait toutes les fonctionnalités sous la catégorie) pour tous les utilisateurs des groupes spécifiés.
Exemple 7
Add-VivaModuleFeaturePolicy -CategoryId <category_id> -Name MultipleUsers -IsCategoryEnabled $false -UserIds user1@contoso.com,user2@contoso.comCet exemple montre comment ajouter une stratégie pour la <category_id> catégorie dans Viva. La stratégie désactive la catégorie (en fait toutes les fonctionnalités sous la catégorie) pour les utilisateurs spécifiés.
Exemple 8
Add-VivaModuleFeaturePolicy -CategoryId <category_id> -Name UsersAndGroups -IsCategoryEnabled $false -GroupIds group1@contoso.com,group2@contoso.com,57680382-61a5-4378-85ad-f72095d4e9c3 -UserIds user1@contoso.com,user2@contoso.comCet exemple montre comment ajouter une stratégie pour la <category_id> catégorie dans Viva. La stratégie désactive la catégorie (en fait toutes les fonctionnalités sous la catégorie) pour les utilisateurs et les membres du groupe spécifiés.
Exemple 9
Add-VivaModuleFeaturePolicy -CategoryId <category_id> -Name "Disable Category For All" -IsCategoryEnabled $false -EveryoneCet exemple ajoute une stratégie pour la <category_id> catégorie dans Viva où le nom de la stratégie est avec des espaces. La stratégie désactive la catégorie (en fait toutes les fonctionnalités de la catégorie) pour tous les utilisateurs du organization.
Paramètres
-CategoryId
Ce paramètre est disponible dans la version 3.5.0-Preview2 ou ultérieure du module.
Remarque : Actuellement, aucune catégorie n’est disponible dans Viva. Nous allons mettre à jour la documentation lorsque des catégories sont disponibles.
Le paramètre CategoryId spécifie la catégorie Viva pour laquelle vous souhaitez ajouter la stratégie.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
| S’applique à: | Exchange Online |
-Confirm
Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.
- Les applets de commande destructrices (par exemple, les applets de commande Remove-*) comportent une pause intégrée qui vous oblige à accuser réception de la commande avant de continuer. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte :
-Confirm:$false. - La plupart des autres applets de commande (par exemple, les applets de commande New-* et Set-*) n'ont pas de pause intégrée. Pour ces cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.
Cette applet de commande a une pause intégrée. Utilisez -Confirm:$false donc pour ignorer la confirmation.
| Type: | SwitchParameter |
| Alias: | cf |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
| S’applique à: | Exchange Online |
-Everyone
Le commutateur Tout le monde spécifie que la stratégie s’applique à tous les utilisateurs du organization. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
N’utilisez pas ce commutateur avec les paramètres GroupIds ou UserIds.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
| S’applique à: | Exchange Online |
-FeatureId
Le paramètre FeatureId spécifie la fonctionnalité dans le module Viva pour lequel vous souhaitez ajouter la stratégie.
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, utilisez l’applet de commande Get-VivaModuleFeature. La valeur FeatureId est retournée dans la sortie de l’applet de commande.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
| S’applique à: | Exchange Online |
-GroupIds
Le paramètre GroupIds spécifie les adresses e-mail ou les ID d’objet de groupe de sécurité (GUID) des groupes auxquels la stratégie mise à jour s’applique. Les groupes de Microsoft Entra à extension messagerie et non activés pour la messagerie sont pris en charge. Vous pouvez entrer plusieurs valeurs séparées par des virgules.
Vous pouvez spécifier un maximum de 20 utilisateurs ou groupes (20 utilisateurs et aucun groupe, 10 utilisateurs et 10 groupes, etc.).
Pour que la stratégie s’applique à tous les utilisateurs du organization, utilisez le commutateur Tout le monde.
Remarque : Dans la version 3.5.1-Preview2 ou ultérieure du module, ce paramètre prend en charge les ID d’objet de groupe de sécurité (GUID). Les versions précédentes du module acceptent uniquement les adresses e-mail pour ce paramètre.
| Type: | String[] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
| S’applique à: | Exchange Online |
-IsCategoryEnabled
Ce paramètre est disponible dans la version 3.5.0-Preview2 ou ultérieure du module.
Remarque : Actuellement, aucune catégorie n’est disponible dans Viva. Nous allons mettre à jour la documentation lorsque des catégories sont disponibles.
Le paramètre IsCategoryEnabled spécifie si la catégorie est activée ou non par la stratégie. Les valeurs valides sont les suivantes :
- $true : la catégorie est activée par la stratégie.
- $false : la catégorie n’est pas activée par la stratégie.
| Type: | Boolean |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
| S’applique à: | Exchange Online |
-IsFeatureEnabled
Le paramètre IsFeatureEnabled spécifie si la fonctionnalité est activée ou non par la stratégie. Les valeurs valides sont les suivantes :
- $true : la fonctionnalité est activée par la stratégie.
- $false : la fonctionnalité n’est pas activée par la stratégie.
| Type: | Boolean |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
| S’applique à: | Exchange Online |
-IsUserControlEnabled
Ce paramètre est disponible dans la version 3.3.0 ou ultérieure du module.
Le paramètre IsUserControlEnabled spécifie si le contrôle utilisateur est activé par la stratégie. Les valeurs valides sont les suivantes :
- $true : le contrôle utilisateur est activé par la stratégie. Les utilisateurs peuvent refuser la fonctionnalité.
- $false : le contrôle utilisateur n’est pas activé par la stratégie. Les utilisateurs ne peuvent pas choisir la fonctionnalité.
Seules les fonctionnalités qui permettent aux administrateurs d’activer et de désactiver les contrôles utilisateur par stratégie peuvent utiliser ce paramètre. Si la fonctionnalité ne prend pas en charge le basculement des contrôles utilisateur par les administrateurs, la valeur par défaut s’applique. Pour plus d’informations, consultez la documentation sur les fonctionnalités.
| Type: | Boolean |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
| S’applique à: | Exchange Online |
-ModuleId
Le paramètre ModuleId spécifie le module Viva pour lequel vous souhaitez ajouter la stratégie de fonctionnalité.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
| S’applique à: | Exchange Online |
-Name
Le paramètre Name spécifie le nom de la stratégie. La longueur maximale est de 256 caractères. Si la valeur contient des espaces, placez-la entre guillemets (").
Les caractères valides sont des lettres, des chiffres, des virgules, des points et des espaces en anglais.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
| S’applique à: | Exchange Online |
-ResultSize
Ce paramètre est réservé à l’usage interne chez Microsoft.
| Type: | Unlimited |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
| S’applique à: | Exchange Online |
-UserIds
Le paramètre UserIds spécifie les noms d’utilisateur principal (UPN) des utilisateurs auxquels la stratégie s’applique. Vous pouvez entrer plusieurs valeurs séparées par des virgules.
Vous pouvez spécifier un maximum de 20 utilisateurs ou groupes (20 utilisateurs et aucun groupe, 10 utilisateurs et 10 groupes, etc.).
Pour que la stratégie s’applique à tous les utilisateurs du organization, utilisez le commutateur Tout le monde.
| Type: | String[] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
| S’applique à: | Exchange Online |
-WhatIf
Le commutateur WhatIf simule les actions de la commande. Vous pouvez utiliser ce commutateur pour afficher les modifications qui se produiraient sans réellement appliquer ces modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
| Type: | SwitchParameter |
| Alias: | wi |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
| S’applique à: | Exchange Online |