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 , qu’il soit activé, désactivé ou autorise les essais sans mode de paiement
- Affichez la liste des produits applicables et indiquez si l’achat en libre-service est activé, désactivé ou autorise les essais sans mode de paiement
- Afficher ou modifier le paramètre actuel d’un produit spécifique pour l’activer ou le désactiver
- Afficher ou modifier le paramètre pour les essais sans modes 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.
- PowerShell 5 ou version antérieure. Actuellement, PowerShell 6.x/7.x n’est pas pris en charge avec ce module.
- Le rôle d’administrateur général ou d’administrateur de facturation pour votre locataire afin de modifier les stratégies de produit MSCommerce .
- Rôle de lecteur global pour votre locataire afin d’afficher une liste en lecture seule des stratégies de produit MSCommerce .
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
Afficher la liste des produits achetés en libre-service et leurs status
Pour afficher la liste de tous les produits d’achat 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.
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 ID ont changé. 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 la liste des « types d’offres tierces » d’achat 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 le status pour AllowSelfServicePurchase
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. Vous pouvez également utiliser la valeur OnlyTrialsWithoutPaymentMethod pour permettre aux utilisateurs d’essayer des produits qui n’ont pas de paiement d’essai requis. Reportez-vous à la liste des produits ci-dessus pour connaître les produits pour lesquels ces essais sont activés. 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 | Impact |
---|---|
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. |
Pour obtenir le paramètre de stratégie d’un produit spécifique, exécutez la commande suivante :
Get-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId CFQ7TTC0KP0N
Pour activer le paramètre de stratégie pour un produit spécifique, exécutez la commande suivante :
Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId CFQ7TTC0KP0N -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 CFQ7TTC0KP0N -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 CFQ7TTC0KP0N -Value "OnlyTrialsWithoutPaymentMethod"
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 :
Update-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ésolution des problèmes
Problème
Le message d’erreur suivant s’affiche :
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
Solution
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)