AllowSelfServicePurchase gebruiken voor de MSCommerce PowerShell-module

De MSCommerce PowerShell-module is nu beschikbaar op PowerShell Gallery. De module bevat een PolicyID-parameterwaarde voor AllowSelfServicePurchase waarmee u kunt bepalen of gebruikers in uw organisatie selfservice-aankopen van Microsoft kunnen doen of aanbiedingen van derden kunnen selecteren.

U kunt de MSCommerce PowerShell-module gebruiken om het volgende te doen:

• De standaardstatus van de parameterwaarde AllowSelfServicePurchase weergeven, ongeacht of deze is ingeschakeld, uitgeschakeld of proefversies zonder betalingswijze toestaat
• Bekijk een lijst met toepasselijke producten en of selfservice-aankoop is ingeschakeld, uitgeschakeld of proefversies zonder betalingswijze toestaat
• De huidige instelling voor een specifiek product weergeven of wijzigen om deze in of uit te schakelen
• De instelling voor proefversies zonder betalingswijzen weergeven of wijzigen

Vereisten

Als u de MSCommerce PowerShell-module wilt gebruiken, hebt u het volgende nodig:

• Een Windows 10 of hoger besturingssysteem.
• PowerShell 5 of lager. Momenteel wordt PowerShell 6.x/7.x niet ondersteund met deze module.
• De rol Globale of Factureringsbeheerder voor uw tenant om het MSCommerce-productbeleid te wijzigen.
• De rol Globale lezer voor uw tenant om een alleen-lezenlijst met MSCommerce-productbeleid te zien.

De MSCommerce PowerShell-module installeren

U installeert de MSCommerce PowerShell-module eenmaal op uw Windows 10-apparaat en importeert deze vervolgens in elke PowerShell-sessie die u start. Download de MSCommerce PowerShell-module van de PowerShell Gallery.

Voer de volgende opdracht uit om de MSCommerce PowerShell-module met PowerShellGet te installeren:

Install-Module -Name MSCommerce

MSCommerce importeren in de PowerShell-sessie

Nadat u de module op uw Windows 10 apparaat hebt geïnstalleerd, importeert u deze in elke PowerShell-sessie die u start. Voer de volgende opdracht uit om deze te importeren in een PowerShell-sessie:

Import-Module -Name MSCommerce

Verbinding maken met MSCommerce met uw referenties

Voer de volgende opdracht uit om verbinding te maken met de PowerShell-module met uw referenties.

Connect-MSCommerce

Met deze opdracht wordt de huidige PowerShell-sessie verbonden met een Microsoft Entra tenant. De opdracht vraagt u om een gebruikersnaam en wachtwoord voor de tenant waarmee u verbinding wilt maken. Als meervoudige verificatie is ingeschakeld voor uw referenties, gebruikt u de interactieve optie om u aan te melden.

Details weergeven voor AllowSelfServiceAankoop

Voer de volgende opdracht uit om een beschrijving van de parameterwaarde AllowSelfServicePurchase en de standaardstatus weer te geven op basis van uw organisatie:

Get-MSCommercePolicy -PolicyId AllowSelfServicePurchase

Een lijst met selfserviceaankoopproducten en hun status weergeven

Voer de volgende opdracht uit om een lijst met alle beschikbare selfserviceaankoopproducten en de status van elk product weer te geven:

Get-MSCommerceProductPolicies -PolicyId AllowSelfServicePurchase

De volgende tabel bevat de beschikbare producten en de bijbehorende ProductId. Ook wordt aangegeven voor welke producten een proefversie beschikbaar is en waarvoor geen betalingswijze is vereist. Indien van toepassing, vereisen alle andere proefversies een betalingswijze. Voor de producten waarvoor een proefversie is ingeschakeld zonder betalingswijze, kunt u de proefversie inschakelen, terwijl de mogelijkheid om het product te kopen uitgeschakeld blijft. Zie De status voor AllowSelfServicePurchase weergeven of instellen voor voorbeeldopdrachten.

Product	Productid	Is proefversie zonder betalingswijze ingeschakeld?
Clipchamp Premium	CFQ7TTC0N8SS	Neen
Power Apps per gebruiker*	CFQ7TTC0LH2H	Neen
Power Automate per gebruiker*	CFQ7TTC0LH3L	Neen
Power Automate RPA*	CFQ7TTC0LSGZ	Neen
Power BI Premium (zelfstandig)*	CFQ7TTC0H6RP	Neen
Power BI Pro*	CFQ7TTC0H9MP	Neen
Project Abonnement 1*	CFQ7TTC0HDB1	Ja
Project Abonnement 3*	CFQ7TTC0HDB0	Neen
Teams Verkennend	CFQ7TTC0J1FV	Ja
Introductieprijzen voor Teams Premium	CFQ7TTC0RM8K	Ja
Visio Abonnement 1*	CFQ7TTC0HD33	Ja
Visio Abonnement 2*	CFQ7TTC0HD32	Neen
Viva Goals (alleen proefversies voor selfservice)	CFQ7TTC0PW0V	Ja
Windows 365 Enterprise	CFQ7TTC0HHS9	Neen
Windows 365 Business	CFQ7TTC0J203	Neen
Windows 365 Business met Windows Hybrid Benefit	CFQ7TTC0HX99	Neen
Microsoft 365 F3	CFQ7TTC0LH05	Neen
Microsoft Purview Discovery	CFQ7TTC0N8SL	Ja

*Deze id's zijn gewijzigd. Als u producten eerder hebt geblokkeerd met de oude id's, worden ze automatisch geblokkeerd met behulp van de nieuwe id's. Er is geen ander werk vereist.

Bekijk een lijst met selfserviceaankoop 'aanbiedingstypen van derden' en hun status

Voer de volgende opdracht uit om een lijst met alle beschikbare aanbiedingstypen voor selfserviceaankopen van derden en de status van elke aanbieding weer te geven:

Get-MSCommerceProductPolicies -PolicyId AllowSelfServicePurchase -Scope OfferType

De volgende tabel bevat de beschikbare aanbiedingstypen van derden. Deze aanbiedingstypen kunnen worden in- of uitgeschakeld voor selfserviceaankopen.

Aanbiedingstype	ID
Software as a Service	Saas
Power BI-visuals	POWERBIVISUALS
Dynamics 365 Dataverse-apps	DYNAMICSCE
Dynamics 365 Business Central	DYNAMICSBC

De status voor AllowSelfServiceAankoop weergeven of instellen

U kunt de parameter Value voor AllowSelfServicePurchase instellen om toe te staan of te voorkomen dat gebruikers een selfserviceaankoop doen. U kunt ook de waarde OnlyTrialsWithoutPaymentMethod gebruiken om gebruikers toe te staan producten uit te proberen waarvoor geen proefversies zijn vereist voor betaling. Raadpleeg de bovenstaande productlijst om te zien voor welke producten deze proefversies zijn ingeschakeld. Gebruikers kunnen het product alleen kopen nadat de proefversie is afgelopen als AllowSelfServicePurchase is ingeschakeld.

Opmerking

Het wijzigen van de waarde voor AllowSelfServicePurchase of OnlyTrialsWithoutPaymentMethod heeft vanaf dat moment alleen gevolgen voor proefversies of aankopen voor het opgegeven product. Bestaande proefversies of aankopen voor het opgegeven product worden niet beïnvloed.

In de volgende tabel worden de instellingen voor de parameter Waarde beschreven.

Instelling	Gevolg
Ingeschakeld	Gebruikers kunnen selfserviceaankopen doen en proefversies voor het product aanschaffen.
OnlyTrialsWithoutPaymentMethod	Gebruikers kunnen geen selfserviceaankopen doen, maar kunnen gratis proefversies verkrijgen voor producten waarvoor ze geen betalingswijze hoeven toe te voegen. Nadat de proefversie is verlopen, kan een gebruiker de betaalde versie van het product niet kopen.
Uitgeschakeld	Gebruikers kunnen geen selfserviceaankopen doen of proefversies voor het product aanschaffen.

Voer de volgende opdracht uit om de beleidsinstelling voor een specifiek product op te halen:

Get-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId CFQ7TTC0KP0N

Voer de volgende opdracht uit om de beleidsinstelling voor een specifiek product in te schakelen:

Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId CFQ7TTC0KP0N -Value "Enabled"

Voer de volgende opdracht uit om de beleidsinstelling voor een specifiek product uit te schakelen:

Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId CFQ7TTC0KP0N -Value "Disabled"

Voer de volgende opdracht uit om gebruikers toe te staan een specifiek product zonder betalingswijze uit te proberen:

Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId CFQ7TTC0KP0N -Value "OnlyTrialsWithoutPaymentMethod" 

Voer de volgende opdracht uit om de beleidsinstelling voor een specifiek aanbiedingstype van derden op te halen:

Get-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -OfferType <ID>

Voer de volgende opdracht uit om de beleidsinstelling in te schakelen voor een specifiek type aanbieding van derden:

Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -OfferType <ID> -Value "Enabled"

Als u de beleidsinstelling voor een specifiek aanbiedingstype van derden wilt uitschakelen, voert u de volgende opdracht uit:

Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -OfferType <ID> -Value "Disabled"

Voorbeeldscript om AllowSelfServiceAankoop uit te schakelen

In het volgende voorbeeld wordt uitgelegd hoe u de MSCommerce-module importeert, zich aanmeldt met uw account, de ProductId voor Power Automate per gebruiker opkrijgt en vervolgens AllowSelfServicePurchase voor dat product uitschakelt.

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"

Als er meerdere waarden voor het product zijn, kunt u de opdracht afzonderlijk uitvoeren voor elke waarde, zoals wordt weergegeven in het volgende voorbeeld:

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"

Probleemoplossing

Probleem

U ziet het volgende foutbericht:

HandleError: Kan beleid niet ophalen met PolicyId 'AllowSelfServicePurchase', ErrorMessage - De onderliggende verbinding is gesloten: er is een onverwachte fout opgetreden bij een verzenden.

Dit kan worden veroorzaakt door een oudere versie van TLS (Transport Layer Security). Wanneer u verbinding maakt met deze service, moet u TLS 1.2 of hoger gebruiken

Oplossing

Voer een upgrade uit naar TLS 1.2. Met de volgende syntaxis wordt het ServicePointManager-beveiligingsprotocol bijgewerkt om TLS1.2 toe te staan:

[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12

Zie TLS 1.2 inschakelen voor meer informatie.

Verwante onderwerpen

Selfserviceaankopen beheren (Beheer) (artikel)
Veelgestelde vragen over selfservice-aankopen (artikel)