Utiliser AllowSelfServicePurchase pour le module PowerShell MSCommerce
Le module MsCommerce PowerShell est disponible dans le PowerShell Gallery. Le module inclut une valeur de paramètre PolicyID pour AllowSelfServicePurchase qui vous permet de contrôler si les utilisateurs de votre organization peuvent effectuer des achats en libre-service de Microsoft ou sélectionner des offres tierces.
Vous pouvez également gérer les paramètres AllowSelfServicePurchase dans le Centre d’administration Microsoft 365. Pour plus d’informations, consultez Gérer les achats et les essais en libre-service (pour les administrateurs).
Vous pouvez utiliser le module PowerShell MSCommerce pour :
- Afficher l’état par défaut de la valeur du paramètre AllowSelfServicePurchase
- Afficher la liste des produits applicables et leur valeur de paramètre AllowSelfServicePurchase
- Afficher ou modifier le paramètre actuel d’un produit spécifique pour l’activer ou le désactiver
- Pour les produits Microsoft uniquement : afficher ou modifier le paramètre pour les essais sans mode de paiement
Configuration requise
Pour utiliser le module PowerShell MSCommerce , vous avez besoin des éléments suivants :
- Système d’exploitation Windows 10 ou version ultérieure.
- Le rôle Administrateur général ou d’administrateur de facturation pour votre locataire afin de modifier les stratégies de produit MSCommerce .
Attention
Les administrateurs généraux disposent d’un accès quasi illimité aux paramètres de votre organization et à la plupart de ses données. Pour assurer la sécurité de vos organization, nous vous recommandons de limiter autant que possible le nombre d’administrateurs généraux.
- Rôle de lecteur global pour votre locataire afin d’afficher une liste en lecture seule des stratégies de produit MSCommerce .
- Les partenaires administrateurs au nom de (AOBO) d’un client doivent avoir un rôle défini sur Administrateur général pour gérer et désactiver les achats en libre-service dans le Centre d’administration Microsoft 365 et via PowerShell.
Prise en main du module PowerShell MSCommerce
Pour commencer à utiliser le module PowerShell MSCommerce , vous devez l’installer, l’importer dans une session PowerShell, puis vous y connecter avec vos informations d’identification.
Installer le module PowerShell MSCommerce
Vous installez le module PowerShell MSCommerce sur votre appareil Windows 10 une fois, puis vous l’importez dans chaque session PowerShell que vous démarrez. Téléchargez le module PowerShell MSCommerce à partir du PowerShell Gallery.
Pour installer le module PowerShell MSCommerce avec PowerShellGet, exécutez la commande suivante :
Install-Module -Name MSCommerce
Importer MSCommerce dans la session PowerShell
Après avoir installé le module sur votre appareil Windows 10, vous l’importez dans chaque session PowerShell que vous démarrez. Pour l’importer dans une session PowerShell, exécutez la commande suivante :
Import-Module -Name MSCommerce
Se connecter à MSCommerce avec vos informations d’identification
Pour vous connecter au module PowerShell avec vos informations d’identification, exécutez la commande suivante.
Connect-MSCommerce
Cette commande connecte la session PowerShell actuelle à un locataire Microsoft Entra. La commande vous invite à entrer un nom d’utilisateur et un mot de passe pour le locataire auquel vous souhaitez vous connecter. Si l’authentification multifacteur est activée pour vos informations d’identification, vous utilisez l’option interactive pour vous connecter.
Afficher les détails de AllowSelfServicePurchase
Pour afficher une description de la valeur du paramètre AllowSelfServicePurchase et de la status par défaut, en fonction de votre organization, exécutez la commande suivante :
Get-MSCommercePolicy -PolicyId AllowSelfServicePurchase
Utiliser AllowSelfServicePurchase avec les produits Microsoft
Cette section contient des informations sur la façon d’afficher une liste de produits Microsoft à acheter en libre-service, leur status actuel et la façon de définir les status. Pour plus d’informations sur les types d’offres tierces, consultez Utiliser AllowSelfServicePurchase avec des types d’offres tiers.
Afficher la liste des produits Microsoft achetés en libre-service et leurs status
Pour afficher la liste des produits Microsoft achetés en libre-service disponibles et les status de chacun d’eux, exécutez la commande suivante :
Get-MSCommerceProductPolicies -PolicyId AllowSelfServicePurchase
Le tableau suivant répertorie les produits disponibles et leur ProductId. Il indique également quels produits ont une version d’évaluation disponible et ne nécessitent pas de mode de paiement. Le cas échéant, tous les autres essais nécessitent un mode de paiement. Pour les produits pour lesquels la version d’évaluation sans mode de paiement est activé, vous pouvez activer la version d’évaluation, tout en gardant la possibilité d’acheter le produit désactivée. Pour obtenir des exemples de commandes, consultez Afficher ou définir les status pour AllowSelfServicePurchase pour les produits Microsoft.
| Product | Productid | La version d’évaluation sans mode de paiement est-elle activée ? |
|---|---|---|
| Clipchamp Premium | CFQ7TTC0N8SS | Non |
| Microsoft 365 Copilot | CFQ7TTC0MM8R | Non |
| Microsoft 365 F3 | CFQ7TTC0LH05 | Non |
| Découverte Microsoft Purview | CFQ7TTC0N8SL | Oui |
| Power Apps par utilisateur* | CFQ7TTC0LH2H | Non |
| Power Automate par utilisateur* | CFQ7TTC0LH3L | Non |
| RPA Power Automate* | CFQ7TTC0LSGZ | Non |
| Power BI Premium (autonome)* | CFQ7TTC0H6RP | Non |
| Power BI Pro* | CFQ7TTC0H9MP | Non |
| Planificateur Plan 1* | CFQ7TTC0HDB1 | Oui |
| Project (plan 3)* | CFQ7TTC0HDB0 | Non |
| Python dans Excel | CFQ7TTC0S3X1 | Non |
| Teams Exploratoire | CFQ7TTC0J1FV | Oui |
| Teams Premium prix d’introduction | CFQ7TTC0RM8K | Oui |
| Visio (plan 1)* | CFQ7TTC0HD33 | Oui |
| Visio (plan 2)* | CFQ7TTC0HD32 | Non |
| Viva Goals (essais en libre-service uniquement) | CFQ7TTC0PW0V | Oui |
*Ces éléments sont des ID mis à jour. Si vous avez précédemment bloqué des produits à l’aide des anciens ID, ils sont automatiquement bloqués à l’aide des nouveaux ID. Aucun autre travail n’est nécessaire.
Afficher ou définir la status pour AllowSelfServicePurchase pour les produits Microsoft
Vous pouvez définir le paramètre Value pour AllowSelfServicePurchase afin d’autoriser ou d’empêcher les utilisateurs d’effectuer un achat en libre-service d’un produit Microsoft. Vous pouvez également utiliser la valeur OnlyTrialsWithoutPaymentMethod pour permettre aux utilisateurs d’essayer des produits qui n’ont pas de paiement d’essai requis. Pour voir quels produits sont activés pour lesquels ces essais sont activés, consultez la liste des produits Microsoft achetés en libre-service et leurs status. Les utilisateurs peuvent acheter le produit uniquement après la fin de la version d’évaluation si AllowSelfServicePurchase est activé.
Remarque
La modification de la valeur de AllowSelfServicePurchase ou OnlyTrialsWithoutPaymentMethod affecte uniquement les essais ou les achats effectués pour le produit spécifié à partir de ce moment. Les essais ou achats existants pour le produit spécifié ne sont pas affectés.
Le tableau suivant décrit les paramètres du paramètre Value .
| Setting | Résultat |
|---|---|
| Activé | Les utilisateurs peuvent effectuer des achats en libre-service et acquérir des essais pour le produit. |
| OnlyTrialsWithoutPaymentMethod | Les utilisateurs ne peuvent pas effectuer d’achats en libre-service, mais peuvent acquérir des essais gratuits pour les produits qui n’ont pas besoin d’ajouter un mode de paiement. Une fois la version d’évaluation expirée, un utilisateur ne peut pas acheter la version payante du produit. |
| Désactivé | Les utilisateurs ne peuvent pas effectuer d’achats en libre-service ou acquérir des essais pour le produit. |
Utilisez les commandes suivantes pour obtenir ou définir les paramètres de stratégie, où <ProductID> est la chaîne associée au nom du produit.
Pour obtenir le paramètre de stratégie d’un produit spécifique, exécutez la commande suivante :
Get-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId ```<ProductID>```
Pour activer le paramètre de stratégie pour un produit spécifique, exécutez la commande suivante :
Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId <ProductID> -Value "Enabled"
Pour désactiver le paramètre de stratégie pour un produit spécifique, exécutez la commande suivante :
Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId <ProductID> -Value "Disabled"
Pour permettre aux utilisateurs d’essayer un produit spécifique sans mode de paiement, exécutez la commande suivante :
Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId <ProductID> -Value "OnlyTrialsWithoutPaymentMethod"
Utiliser AllowSelfServicePurchase avec des types d’offres tiers
Cette section contient des informations sur la façon d’afficher une liste d’achats en libre-service pour les types d’offres tierces et leurs status, et sur la façon de définir les status.
Afficher la liste des types d’offres tierces achetées en libre-service et leurs status
Pour afficher la liste de tous les types d’offres tierces d’achat en libre-service disponibles et les status de chacun, exécutez la commande suivante :
Get-MSCommerceProductPolicies -PolicyId AllowSelfServicePurchase -Scope OfferType
Le tableau suivant répertorie les types d’offres tierces disponibles. Ces types d’offres peuvent être activés ou désactivés pour l’achat en libre-service.
| Type d’offre | ID |
|---|---|
| Software as a Service | SaaS |
| Visuels Power BI | POWERBIVISUALS |
| Dynamics 365 Dataverse Apps | DYNAMICSCE |
| Dynamics 365 Business Central | DYNAMICSBC |
Afficher ou définir la status pour AllowSelfServicePurchase pour les types d’offres tierces
Vous pouvez définir le paramètre Value pour AllowSelfServicePurchase afin d’autoriser ou d’empêcher les utilisateurs d’effectuer un achat en libre-service d’un type d’offre tierce.
Le tableau suivant décrit les paramètres du paramètre Value .
| Setting | Résultat |
|---|---|
| Activé | Les utilisateurs peuvent effectuer des achats en libre-service et acquérir des essais pour le produit. |
| Désactivé | Les utilisateurs ne peuvent pas effectuer d’achats en libre-service ou acquérir des essais pour le produit. |
Utilisez les commandes suivantes pour obtenir ou définir les paramètres de stratégie, où <ID> est la chaîne associée au type d’offre.
Pour obtenir le paramètre de stratégie pour un type d’offre tiers spécifique, exécutez la commande suivante :
Get-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -OfferType <ID>
Pour activer le paramètre de stratégie pour un type d’offre tiers spécifique, exécutez la commande suivante :
Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -OfferType <ID> -Value "Enabled"
Pour désactiver le paramètre de stratégie pour un type d’offre tiers spécifique, exécutez la commande suivante :
Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -OfferType <ID> -Value "Disabled"
Exemple de script pour désactiver AllowSelfServicePurchase
L’exemple suivant vous montre comment importer le module MSCommerce , vous connecter avec votre compte, obtenir le ProductId pour Power Automate par utilisateur, puis désactiver AllowSelfServicePurchase pour ce produit.
Import-Module -Name MSCommerce
Connect-MSCommerce #sign-in with your global or billing administrator account when prompted
$product = Get-MSCommerceProductPolicies -PolicyId AllowSelfServicePurchase | where {$_.ProductName -match 'Power Automate per user'}
Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId $product.ProductID -Value "Disabled"
S’il existe plusieurs valeurs pour le produit, vous pouvez exécuter la commande individuellement pour chaque valeur, comme indiqué dans l’exemple suivant :
foreach ($id in $product.ProductID) {UpdateUpdate-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId $product[0].ProductID -Value "Disabled"
Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId $product[1].ProductID -Value "Disabled"
Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -OfferType SaaS -Value "Disabled"}
Résoudre les problèmes de HandleError : échec de la récupération de la stratégie avec PolicyId « AllowSelfServicePurchase »
Dans certains cas, le message d’erreur suivant peut s’afficher :
HandleError : échec de la récupération de la stratégie avec PolicyId ' AllowSelfServicePurchase', ErrorMessage - La connexion sous-jacente a été fermée : une erreur inattendue s’est produite lors d’un envoi.
Cette erreur peut être due à une version antérieure de TLS (Transport Layer Security). Lorsque vous vous connectez à ce service, vous devez utiliser TLS 1.2 ou une version ultérieure.
Pour résoudre cette erreur, effectuez une mise à niveau vers TLS 1.2. La syntaxe suivante met à jour le protocole de sécurité ServicePointManager pour autoriser TLS1.2 :
[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
Pour en savoir plus, consultez Comment activer TLS 1.2.
Contenu connexe
Gérer les achats en libre-service (Administration) (article)
FAQ sur les achats en libre-service (article)