Update-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 Update-VivaModuleFeaturePolicy pour mettre à jour une stratégie d’accès pour une fonctionnalité d’un module Viva dans Viva.
- Vous ne pouvez pas mettre à jour une stratégie pour un utilisateur ou un groupe particulier afin d’inclure l’ensemble du client si une stratégie pour l’ensemble du client existe déjà pour la fonctionnalité. Une seule stratégie à l’échelle du locataire est prise en charge.
- Les stratégies affectées à un utilisateur ou à un groupe spécifique ont la priorité sur la stratégie affectée à l’ensemble du client pour déterminer si une fonctionnalité est activée. Si plusieurs stratégies sont attribuées à un utilisateur pour 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 client, et non à des utilisateurs ou 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 de contrôles utilisateur (désactivation de l’utilisateur). Reportez-vous à la documentation sur les fonctions pour savoir si des contrôles sont disponibles pour la fonctionnalité pour laquelle vous souhaitez 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)
Update-VivaModuleFeaturePolicy
-FeatureId <String>
-ModuleId <String>
-PolicyId <String>
[-Confirm]
[-Everyone <Boolean>]
[-IsFeatureEnabled <Boolean>]
[-IsUserControlEnabled <Boolean>]
[-IsUserOptedInByDefault <Boolean>]
[-GroupIds <String[]>]
[-Name <String>]
[-ResultSize <Unlimited>]
[-UserIds <String[]>]
[-WhatIf]
[<CommonParameters>]
Description
Utilisez l’applet de commande Update-VivaModuleFeaturePolicy pour mettre à jour une stratégie d’accès pour une fonctionnalité d’un module Viva dans Viva.
Cette applet de commande met à jour les attributs de la stratégie que vous spécifiez. Ces attributs sont les suivants :
- Nom de la stratégie (paramètre Name).
- Indique si la stratégie active ou non la fonctionnalité (paramètre IsFeatureEnabled).
- Indique si la stratégie active ou non les contrôles utilisateur (paramètre IsUserControlEnabled, applicable uniquement à une stratégie de fonctionnalité).
- Les utilisateurs auxquels la stratégie s’applique (paramètres UserIds et GroupIds ou le paramètre Tout le monde).
Vous pouvez mettre à jour ces attributs indépendamment les uns des autres. Par exemple, si vous spécifiez le paramètre Name mais pas le paramètre IsFeatureEnabled, le nom de la stratégie est mis à jour, mais le fait que la stratégie active ou non la fonctionnalité reste inchangé.
Important : les valeurs que vous spécifiez pour les paramètres UserIds et/ou GroupIds ou le paramètre Everyone remplacent les utilisateurs ou groupes existants. Pour conserver les utilisateurs et groupes existants, vous devez spécifier ces utilisateurs ou groupes existants et tout utilisateur ou groupe supplémentaire que vous souhaitez ajouter. Le fait de ne pas inclure les utilisateurs ou groupes existants dans la commande supprime ces utilisateurs ou groupes spécifiques de la stratégie. Pour plus d’informations, consultez les exemples.
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
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b1 -Name NewPolicyName -IsFeatureEnabled $false
Cet exemple met à jour le nom de la stratégie spécifiée et fait en sorte que la stratégie n’active pas la fonctionnalité.
Exemple 2
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -GroupIds group1@contoso.com,group2@contoso.com
Cet exemple met à jour les personnes auxquelles la stratégie spécifiée s’applique. La stratégie s’applique désormais uniquement aux groupes spécifiés, remplaçant les utilisateurs et les groupes auxquels la stratégie s’appliquait.
Exemple 3
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -UserIds user1@contoso.com,user2@contoso.com
Cet exemple met à jour les personnes auxquelles la stratégie spécifiée s’applique. La stratégie s’applique désormais uniquement aux utilisateurs spécifiés, remplaçant les utilisateurs et les groupes auxquels la stratégie s’appliquait.
Exemple 4
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -Name NewPolicyName -IsFeatureEnabled $true -GroupIds group1@contoso.com,57680382-61a5-4378-85ad-f72095d4e9c3 -UserIds user1@contoso.com
Cet exemple met à jour le nom de la stratégie spécifiée, fait en sorte que la stratégie active la fonctionnalité et met à jour les personnes auxquelles la stratégie s’applique. La stratégie s’applique désormais uniquement aux utilisateurs et groupes spécifiés, remplaçant les utilisateurs et les groupes auxquels la stratégie s’appliquait.
Exemple 5
Update-VivaModuleFeaturePolicy -ModuleId PeopleSkills -FeatureId ShowAISkills -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -IsFeatureEnabled $true -IsUserControlEnabled $true -IsUserOptedInByDefault $false
Cet exemple met à jour une stratégie pour la fonctionnalité ShowAISkills dans Viva Skills. La stratégie active la fonctionnalité pour les utilisateurs précédemment ajoutés à la stratégie, autorise les contrôles utilisateur et désactive les utilisateurs par défaut (stratégie de désactivation logicielle).
Paramètres
-Confirm
Applicable : Exchange Online
Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’impact de ce commutateur sur l’applet de commande varie selon que l’applet de commande nécessite une confirmation avant de continuer.
- 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 applets de commande, la spécification du commutateur Confirmer sans valeur introduit une pause qui vous oblige à accuser réception de la commande avant de continuer.
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 paramètre Everyone spécifie que la stratégie mise à jour s’applique à tous les utilisateurs de l’organisation. Les valeurs valides sont les suivantes :
- $true : la stratégie s’applique à tous les utilisateurs. Il s’agit de la seule valeur utile pour ce paramètre.
- $false : N’utilisez pas cette valeur.
Si vous ne souhaitez pas mettre à jour les personnes auxquelles la stratégie s’applique, n’utilisez pas ce paramètre.
N’utilisez pas ce paramètre avec les paramètres GroupIds ou UserIds.
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 |
-FeatureId
Applicable : Exchange Online
Le paramètre FeatureId spécifie la fonctionnalité du module Viva de la stratégie que vous souhaitez mettre à jour.
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 le cmdlet 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 Microsoft Entra à extension messagerie et non à extension messagerie sont pris en charge. Vous pouvez entrer plusieurs valeurs séparées par des virgules.
Si vous ne souhaitez pas mettre à jour les personnes auxquelles la stratégie s’applique, n’utilisez pas ce paramètre.
Les valeurs que vous spécifiez pour ce paramètre ou pour le paramètre UserIds remplacent les groupes existants. Pour conserver les groupes existants, incluez-les avec les nouveaux utilisateurs ou groupes que vous spécifiez.
Vous pouvez spécifier un maximum de 20 utilisateurs ou groupes au total (20 utilisateurs et aucun groupe, 10 utilisateurs et 10 groupes, etc.).
Pour que la stratégie mise à jour s’applique à tous les utilisateurs du organization, utilisez le paramètre Everyone avec la valeur $true.
Remarque : dans la version 3.5.1-Preview2 ou ultérieure du module, ce paramètre prend en charge les ID d’objet du groupe de sécurité (GUID). Les versions précédentes du module n’acceptent que 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 par la stratégie mise à jour. 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.
Si vous ne souhaitez pas mettre à jour si la fonctionnalité est activée par la stratégie, n’utilisez pas ce paramètre.
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 |
-IsUserControlEnabled
Applicable : Exchange Online
Remarque : ce paramètre est disponible dans la version 3.3.0-Preview1 du module ou les versions ultérieures. Si la fonctionnalité prend en charge les contrôles utilisateur pour la désactivation, veillez à définir le paramètre IsUserControlEnabled lorsque vous créez la stratégie. Sinon, les contrôles utilisateur de la stratégie utilisent l’état par défaut de la fonctionnalité.
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 les administrateurs pour basculer les contrôles utilisateur, la valeur par défaut s’applique. Pour plus d’informations, consultez la documentation sur les fonctionnalités.
Si vous ne souhaitez pas mettre à jour si le contrôle utilisateur est activé par la stratégie, n’utilisez pas ce paramètre.
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 la version de module 3.8.0-Preview2 ou ultérieure.
Le paramètre IsUserOptedInByDefault spécifie si les utilisateurs sont choisis par défaut par la stratégie. Les valeurs valides sont les suivantes :
- $true : par défaut, les utilisateurs sont autorisé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’acceptation utilisateur par défaut définie dans les métadonnées de fonctionnalité.
Ce paramètre ne peut être défini que si 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 de la stratégie que vous souhaitez mettre à jour.
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 mis à jour 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 les lettres, chiffres, virgules, points et espaces anglais.
Si vous ne souhaitez pas mettre à jour le nom de la stratégie, n’utilisez pas 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 |
-PolicyId
Applicable : Exchange Online
Le paramètre PolicyId spécifie la stratégie de la fonctionnalité du module Viva que vous souhaitez mettre à jour.
Pour afficher des détails sur les stratégies d’une fonctionnalité d’un module Viva, utilisez l’applet de commande Get-VivaModuleFeaturePolicy. La valeur PolicyId 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 |
-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 mise à jour s’applique. Vous pouvez entrer plusieurs valeurs séparées par des virgules.
Si vous ne souhaitez pas mettre à jour les personnes auxquelles la stratégie s’applique, n’utilisez pas ce paramètre.
Les valeurs que vous spécifiez pour ce paramètre ou pour le paramètre GroupIds remplacent tous les utilisateurs existants. Pour conserver les utilisateurs existants, incluez-les avec les nouveaux utilisateurs ou groupes que vous spécifiez.
Vous pouvez spécifier un maximum de 20 utilisateurs ou groupes au total (20 utilisateurs et aucun groupe, 10 utilisateurs et 10 groupes, etc.).
Pour que la stratégie mise à jour s’applique à tous les utilisateurs du organization, utilisez le paramètre Everyone avec la valeur $true.
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 affiche ce que la commande fait sans apporter de 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 communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.