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.
Utilisez l’applet de commande Add-VivaModuleFeaturePolicy pour ajouter une nouvelle stratégie d’accès pour une fonctionnalité 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é spécifiée pour des utilisateurs, des groupes ou l’ensemble du locataire.
- Vous pouvez affecter jusqu’à 10 stratégies par fonctionnalité. Une stratégie supplémentaire par fonctionnalité 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é. Si plusieurs stratégies sont attribuées à une fonctionnalité (directement en tant qu’utilisateur ou membre d’un groupe), la stratégie la plus restrictive s’applique.
- 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
Default (Par défaut)
Add-VivaModuleFeaturePolicy
-FeatureId <String>
-IsFeatureEnabled <Boolean>
-ModuleId <String>
-Name <String>
[-Confirm]
[-Everyone]
[-GroupIds <String[]>]
[-IsUserControlEnabled <Boolean>]
[-IsUserOptedInByDefault <Boolean>]
[-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é spécifique dans Viva.
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
Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name DisableFeatureForAll -IsFeatureEnabled $false -Everyone
Cet 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-f72095d4e9c3
Cet 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.com
Cet 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.com
Cet 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 -ModuleId PeopleSkills -FeatureId ShowAISkills -Name SoftDisableShowAISkillsPolicy -IsFeatureEnabled $true -IsUserControlEnabled $true -IsUserOptedInByDefault $false -UserIds user1@contoso.com,user2@contoso.com
Cet exemple ajoute une stratégie pour la fonctionnalité ShowAISkills dans Viva Skills. La stratégie active la fonctionnalité pour les utilisateurs spécifiés, autorise les contrôles utilisateur et désactive les utilisateurs par défaut (stratégie de désactivation réversible).
Paramètres
-Confirm
Applicable : Exchange Online
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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
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 |
-Everyone
Applicable : Exchange Online
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.
Propriétés du paramètre
| Type: | SwitchParameter |
| 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 |
-FeatureId
Applicable : Exchange Online
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.
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 |
-GroupIds
Applicable : Exchange Online
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.
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: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-IsFeatureEnabled
Applicable : Exchange Online
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.
Propriétés du paramètre
| Type: | Boolean |
| 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 |
-IsUserControlEnabled
Applicable : Exchange Online
Remarque : Ce paramètre est disponible dans le module version 3.3.0-Preview1 ou ultérieure.
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.
Propriétés du paramètre
| Type: | Boolean |
| 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 |
-IsUserOptedInByDefault
Applicable : Exchange Online
Remarque : Ce paramètre est disponible dans le module version 3.8.0-Preview2 ou ultérieure.
Le paramètre IsUserOptedInByDefault spécifie si les utilisateurs sont activés par défaut par la stratégie. Les valeurs valides sont les suivantes :
- $true : par défaut, les utilisateurs sont activés par la stratégie si l’utilisateur n’a pas défini de préférence.
- $false : par défaut, les utilisateurs sont désactivés par la stratégie si l’utilisateur n’a pas défini de préférence.
Ce paramètre est facultatif et peut être utilisé pour remplacer la valeur d’adhésion utilisateur par défaut définie dans les métadonnées de fonctionnalité.
Ce paramètre ne peut être défini que lorsque le paramètre IsUserControlEnabled est défini sur $true.
Propriétés du paramètre
| Type: | Boolean |
| 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 |
-ModuleId
Applicable : Exchange Online
Le paramètre ModuleId spécifie le module Viva pour lequel vous souhaitez ajouter la stratégie 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
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Name
Applicable : Exchange Online
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.
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 |
-ResultSize
Applicable : Exchange Online
Ce paramètre est réservé à l’usage interne chez Microsoft.
Propriétés du paramètre
| Type: | Unlimited |
| 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 |
-UserIds
Applicable : Exchange Online
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.
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: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WhatIf
Applicable : Exchange Online
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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
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.