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 : 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 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 différents 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. Notez que 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
Add-VivaModuleFeaturePolicy
-FeatureId <String>
-IsFeatureEnabled <Boolean>
-ModuleId <String>
-Name <String>
[-Confirm]
[-GroupIds <String[]>]
[-UserIds <String[]>]
[-Everyone]
[-ResultSize <Unlimited>]
[-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 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
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.comCet 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 -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.
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 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 |
| 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é du module Viva pour laquelle 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 |
| 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 SMTP (adresses e-mail) des groupes auxquels la stratégie s’applique. Les groupes AAD à extension 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.
| 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 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 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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 |
| 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 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 |
| 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 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 |
| 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 |