Update-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 : Cette applet de commande fait partie d’une fonctionnalité qui se trouve actuellement dans une préversion privée fermée. L’applet de commande ne fonctionne pas, sauf si votre organization est membre de la préversion privée.
Utilisez l’applet de commande Update-VivaModuleFeaturePolicy pour mettre à jour une stratégie d’accès pour une fonctionnalité dans un module Viva. La stratégie la plus restrictive pour un utilisateur ou un groupe particulier est prioritaire lors de la détermination si une fonctionnalité est activée.
Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.
Syntax
Update-VivaModuleFeaturePolicy
-FeatureId <String>
-ModuleId <String>
-PolicyId <String>
[-Confirm]
[-IsFeatureEnabled <Boolean>]
[-GroupIds <String[]>]
[-Everyone <Boolean>]
[-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é dans un module 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).
- À qui la stratégie s’applique (les paramètres UserIds et GroupIds ou le paramètre Everyone).
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 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 tous les utilisateurs ou groupes existants. Pour conserver les utilisateurs et groupes existants, vous devez spécifier ces utilisateurs ou groupes existants et tous les utilisateurs ou groupes supplémentaires que vous souhaitez ajouter. Le fait de ne pas inclure d’utilisateurs ou de groupes existants dans la commande supprime efficacement 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 Administrateurs généraux pour exécuter cette applet de commande.
Pour en savoir plus sur les autorisations de rôle d’administrateur dans Azure Active Directory, consultez ID de modèle de rôle.
Exemples
Exemple 1
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b1 -Name NewPolicyName -IsFeatureEnabled $falseCet 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.comCet exemple montre comment mettre à jour les personnes à qui la stratégie spécifiée s’applique. La stratégie s’applique désormais uniquement aux groupes spécifiés, en remplaçant les utilisateurs et les groupes auxquels la stratégie utilisée pour s’appliquer.
Exemple 3
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -UserIds user1@contoso.com,user2@contoso.comCet exemple montre comment mettre à jour les personnes à qui la stratégie spécifiée s’applique. La stratégie s’applique désormais uniquement aux utilisateurs spécifiés, en remplaçant les utilisateurs et les groupes auxquels la stratégie utilisée pour s’appliquer.
Exemple 4
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -Name NewPolicyName -IsFeatureEnabled $true -GroupIds group1@contoso.com -UserIds user1@contoso.comCet 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 à qui la stratégie s’applique. La stratégie s’applique désormais uniquement aux utilisateurs et groupes spécifiés, en remplaçant les utilisateurs et les groupes auxquels la stratégie utilisée pour s’appliquer.
Paramètres
-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-*) ont 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.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Everyone
Le paramètre Everyone spécifie que la stratégie mise à jour s’applique à tous les utilisateurs du organization. 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 à qui la stratégie s’applique, n’utilisez pas ce paramètre.
N’utilisez pas ce paramètre avec les paramètres GroupIds ou UserIds.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-FeatureId
Le paramètre FeatureId spécifie la fonctionnalité dans le 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 l’applet de commande Get-VivaModuleFeature. La valeur FeatureId est retournée dans la sortie de l’applet de commande.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-GroupIds
Le paramètre GroupIds spécifie les adresses e-mail des groupes auxquels la stratégie mise à jour s’applique. Les groupes AAD à 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 à qui la stratégie s’applique, n’utilisez pas ce paramètre.
Les valeurs que vous spécifiez pour ce paramètre ou le paramètre UserIds remplacent tous 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 (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.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-IsFeatureEnabled
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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ModuleId
Le paramètre ModuleId spécifie le module Viva de la stratégie que vous souhaitez mettre à jour.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Name
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 des lettres, des chiffres, des virgules, des points et des espaces en anglais.
Si vous ne souhaitez pas mettre à jour le nom de la stratégie, n’utilisez pas ce paramètre.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-PolicyId
Le paramètre PolicyId spécifie la stratégie de la fonctionnalité dans le module Viva que vous souhaitez mettre à jour.
Pour afficher des détails sur les stratégies d’une fonctionnalité dans un module Viva, utilisez l’applet de commande Get-VivaModuleFeaturePolicy. La valeur PolicyId est retournée dans la sortie de l’applet de commande.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ResultSize
Ce paramètre est réservé à l’usage interne chez Microsoft.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-UserIds
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 à qui la stratégie s’applique, n’utilisez pas ce paramètre.
Les valeurs que vous spécifiez pour ce paramètre ou 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 (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.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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 |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |