Verwenden von AllowSelfServicePurchase für das MSCommerce PowerShell-Modul
Das MSCommerce PowerShell-Modul ist im PowerShell-Katalog verfügbar. Das Modul enthält einen PolicyID-Parameterwert für AllowSelfServicePurchase, mit dem Sie steuern können, ob Benutzer in Ihrem organization Self-Service-Käufe von Microsoft tätigen oder Angebote von Drittanbietern auswählen können.
Sie können auch AllowSelfServicePurchase-Einstellungen im Microsoft 365 Admin Center verwalten. Weitere Informationen finden Sie unter Verwalten von Self-Service-Käufen und Testversionen (für Administratoren).
Sie können das MSCommerce PowerShell-Modul für Folgendes verwenden:
- Anzeigen des Standardzustands des AllowSelfServicePurchase-Parameterwerts
- Anzeigen einer Liste der anwendbaren Produkte und des zugehörigen AllowSelfServicePurchase-Parameters
- Anzeigen oder Ändern der aktuellen Einstellung für ein bestimmtes Produkt, um es entweder zu aktivieren oder zu deaktivieren
- Nur für Microsoft-Produkte: Anzeigen oder Ändern der Einstellung für Testversionen ohne Zahlungsmethoden
Anforderungen
Um das MSCommerce PowerShell-Modul verwenden zu können, benötigen Sie Folgendes:
- Ein Windows 10 oder ein höheres Betriebssystem.
- Die Rolle "Globaler" oder "Abrechnungsadministrator" für Ihren Mandanten, um die MSCommerce-Produktrichtlinien zu ändern.
Achtung
Globale Administratoren haben nahezu unbegrenzten Zugriff auf die Einstellungen Ihrer organization und die meisten seiner Daten. Um Ihre organization zu schützen, empfiehlt es sich, die Anzahl der globalen Administratoren so weit wie möglich zu begrenzen.
- Die Rolle "Globaler Leser" für Ihren Mandanten, um eine schreibgeschützte Liste der MSCommerce-Produktrichtlinien anzuzeigen.
- Partner, die Administratoren im Auftrag eines Kunden (AOBO) sind, müssen über eine Rolle verfügen, die auf "Globaler Administrator" festgelegt ist, um Self-Service-Käufe im Microsoft 365 Admin Center und über PowerShell zu verwalten und zu deaktivieren.
Erste Schritte mit dem MSCommerce PowerShell-Modul
Um mit der Verwendung des MSCommerce PowerShell-Moduls zu beginnen, müssen Sie es installieren, in eine PowerShell-Sitzung importieren und dann mit Ihren Anmeldeinformationen eine Verbindung mit dem Modul herstellen.
Installieren des MSCommerce PowerShell-Moduls
Sie installieren das MSCommerce PowerShell-Modul einmal auf Ihrem Windows 10 Gerät und importieren es dann in jede PowerShell-Sitzung, die Sie starten. Laden Sie das MSCommerce PowerShell-Modul aus dem PowerShell-Katalog herunter.
Führen Sie den folgenden Befehl aus, um das MSCommerce PowerShell-Modul mit PowerShellGet zu installieren:
Install-Module -Name MSCommerce
Importieren von MSCommerce in die PowerShell-Sitzung
Nachdem Sie das Modul auf Ihrem Windows 10 Gerät installiert haben, importieren Sie es in jede PowerShell-Sitzung, die Sie starten. Führen Sie den folgenden Befehl aus, um sie in eine PowerShell-Sitzung zu importieren:
Import-Module -Name MSCommerce
Herstellen einer Verbindung mit MSCommerce mit Ihren Anmeldeinformationen
Führen Sie den folgenden Befehl aus, um mit Ihren Anmeldeinformationen eine Verbindung mit dem PowerShell-Modul herzustellen.
Connect-MSCommerce
Dieser Befehl verbindet die aktuelle PowerShell-Sitzung mit einem Microsoft Entra Mandanten. Der Befehl fordert Sie zur Eingabe eines Benutzernamens und Kennworts für den Mandanten auf, mit dem Sie eine Verbindung herstellen möchten. Wenn die mehrstufige Authentifizierung für Ihre Anmeldeinformationen aktiviert ist, verwenden Sie die interaktive Option für die Anmeldung.
Details für AllowSelfServicePurchase anzeigen
Führen Sie den folgenden Befehl aus, um basierend auf Ihrem organization eine Beschreibung des AllowSelfServicePurchase-Parameters und des Standard-status anzuzeigen:
Get-MSCommercePolicy -PolicyId AllowSelfServicePurchase
Verwenden von AllowSelfServicePurchase mit Microsoft-Produkten
Dieser Abschnitt enthält Informationen zum Anzeigen einer Liste von Microsoft-Produkten für Den Self-Service-Kauf, deren aktuellen status und zum Festlegen der status. Informationen zu Angebotstypen von Drittanbietern finden Sie unter Verwenden von AllowSelfServicePurchase mit Angebotstypen von Drittanbietern.
Anzeigen einer Liste der Microsoft-Produkte mit Self-Service-Kauf und deren status
Führen Sie den folgenden Befehl aus, um eine Liste der verfügbaren Self-Service-Produkte von Microsoft und die status anzuzeigen:
Get-MSCommerceProductPolicies -PolicyId AllowSelfServicePurchase
In der folgenden Tabelle sind die verfügbaren Produkte und deren ProductId aufgeführt. Außerdem wird angegeben, für welche Produkte eine Testversion verfügbar ist und keine Zahlungsmethode erforderlich ist. Falls zutreffend, erfordern alle anderen Testversionen eine Zahlungsmethode. Für die Produkte, für die testversion ohne Zahlungsmethode aktiviert ist, können Sie die Testversion aktivieren, während die Möglichkeit zum Kauf des Produkts deaktiviert bleibt. Beispielbefehle finden Sie unter Anzeigen oder Festlegen der status für AllowSelfServicePurchase für Microsoft-Produkte.
| Produkt | Productid | Ist die Testversion ohne Zahlungsmethode aktiviert? |
|---|---|---|
| Clipchamp Premium | CFQ7TTC0N8SS | Nein |
| Microsoft 365 Copilot | CFQ7TTC0MM8R | Nein |
| Microsoft 365 F3 | CFQ7TTC0LH05 | Nein |
| Microsoft Purview Discovery | CFQ7TTC0N8SL | Ja |
| Power Apps pro Benutzer* | CFQ7TTC0LH2H | Nein |
| Power Automate pro Benutzer* | CFQ7TTC0LH3L | Nein |
| Power Automate RPA* | CFQ7TTC0LSGZ | Nein |
| Power BI Premium (eigenständig)* | CFQ7TTC0H6RP | Nein |
| Power BI Pro* | CFQ7TTC0H9MP | Nein |
| Planner Plan 1* | CFQ7TTC0HDB1 | Ja |
| Project Plan 3* | CFQ7TTC0HDB0 | Nein |
| Python in Excel | CFQ7TTC0S3X1 | Nein |
| Teams Exploratory | CFQ7TTC0J1FV | Ja |
| einführungspreise für Teams Premium | CFQ7TTC0RM8K | Ja |
| Visio Plan 1* | CFQ7TTC0HD33 | Ja |
| Visio Plan 2* | CFQ7TTC0HD32 | Nein |
| Viva Goals (nur Self-Service-Testversionen) | CFQ7TTC0PW0V | Ja |
*Diese Elemente sind aktualisierte IDs. Wenn Sie zuvor Produkte mit den alten IDs blockiert haben, werden diese automatisch mithilfe der neuen IDs blockiert. Es sind keine weiteren Arbeiten erforderlich.
Anzeigen oder Festlegen der status für AllowSelfServicePurchase für Microsoft-Produkte
Sie können den Value-Parameter für AllowSelfServicePurchase festlegen, um Benutzern den Self-Service-Kauf eines Microsoft-Produkts zu erlauben oder zu verhindern. Sie können auch den Wert OnlyTrialsWithoutPaymentMethod verwenden, um Benutzern das Testen von Produkten zu ermöglichen, für die keine Zahlung erforderlich ist. Informationen dazu, für welche Produkte diese Testversionen aktiviert sind, finden Sie in der Produktliste unter Anzeigen einer Liste von Microsoft-Produkten zum Self-Service-Kauf und deren status. Benutzer können das Produkt erst nach Ablauf der Testversion kaufen, wenn AllowSelfServicePurchase aktiviert ist.
Hinweis
Das Ändern des Werts für AllowSelfServicePurchase oder OnlyTrialsWithoutPaymentMethod wirkt sich nur auf Testversionen oder Käufe aus, die ab diesem Zeitpunkt für das angegebene Produkt getätigt wurden. Vorhandene Testversionen oder Käufe für das angegebene Produkt sind nicht betroffen.
In der folgenden Tabelle werden die Einstellungen für den Value-Parameter beschrieben.
| Einstellung | Ergebnis |
|---|---|
| Aktiviert | Benutzer können Self-Service-Käufe tätigen und Testversionen für das Produkt erwerben. |
| OnlyTrialsWithoutPaymentMethod | Benutzer können keine Self-Service-Einkäufe tätigen, aber kostenlose Testversionen für Produkte erwerben, für die sie keine Zahlungsmethode hinzufügen müssen. Nach Ablauf der Testversion kann ein Benutzer die kostenpflichtige Version des Produkts nicht mehr kaufen. |
| Deaktiviert | Benutzer können keine Self-Service-Käufe tätigen oder Testversionen für das Produkt erwerben. |
Verwenden Sie die folgenden Befehle, um Richtlinieneinstellungen abzurufen oder festzulegen, wobei <ProductID> die Zeichenfolge ist, die dem Produktnamen zugeordnet ist.
Führen Sie den folgenden Befehl aus, um die Richtlinieneinstellung für ein bestimmtes Produkt abzurufen:
Get-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId ```<ProductID>```
Führen Sie den folgenden Befehl aus, um die Richtlinieneinstellung für ein bestimmtes Produkt zu aktivieren:
Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId <ProductID> -Value "Enabled"
Führen Sie den folgenden Befehl aus, um die Richtlinieneinstellung für ein bestimmtes Produkt zu deaktivieren:
Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId <ProductID> -Value "Disabled"
Führen Sie den folgenden Befehl aus, damit Benutzer ein bestimmtes Produkt ohne Zahlungsmethode ausprobieren können:
Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId <ProductID> -Value "OnlyTrialsWithoutPaymentMethod"
Verwenden von AllowSelfServicePurchase mit Angebotstypen von Drittanbietern
Dieser Abschnitt enthält Informationen zum Anzeigen einer Liste von Self-Service-Käufen für Angebotstypen von Drittanbietern und deren status sowie zum Festlegen der status.
Anzeigen einer Liste der Self-Service-Kaufangebote von Drittanbietern und deren status
Führen Sie den folgenden Befehl aus, um eine Liste aller verfügbaren Angebotstypen für Self-Service-Käufe von Drittanbietern und die jeweils status anzuzeigen:
Get-MSCommerceProductPolicies -PolicyId AllowSelfServicePurchase -Scope OfferType
In der folgenden Tabelle sind die verfügbaren Angebotstypen von Drittanbietern aufgeführt. Diese Angebotstypen können für den Self-Service-Kauf aktiviert oder deaktiviert werden.
| Angebotstyp | ID |
|---|---|
| Software-as-a-Service | SaaS |
| Power BI-Visuals | POWERBIVISUALS |
| Dynamics 365 Dataverse Apps | DYNAMICSCE |
| Dynamics 365 Business Central | DYNAMICSBC |
Anzeigen oder Festlegen der status für AllowSelfServicePurchase für Angebotstypen von Drittanbietern
Sie können den Value-Parameter für AllowSelfServicePurchase festlegen, um Benutzern den Self-Service-Kauf eines Drittanbieterangebotstyps zu erlauben oder zu verhindern.
In der folgenden Tabelle werden die Einstellungen für den Value-Parameter beschrieben.
| Einstellung | Ergebnis |
|---|---|
| Aktiviert | Benutzer können Self-Service-Käufe tätigen und Testversionen für das Produkt erwerben. |
| Deaktiviert | Benutzer können keine Self-Service-Käufe tätigen oder Testversionen für das Produkt erwerben. |
Verwenden Sie die folgenden Befehle, um Richtlinieneinstellungen abzurufen oder festzulegen, wobei <ID> die dem Angebotstyp zugeordnete Zeichenfolge ist.
Führen Sie den folgenden Befehl aus, um die Richtlinieneinstellung für einen bestimmten Angebotstyp eines Drittanbieters abzurufen:
Get-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -OfferType <ID>
Führen Sie den folgenden Befehl aus, um die Richtlinieneinstellung für einen bestimmten Angebotstyp eines Drittanbieters zu aktivieren:
Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -OfferType <ID> -Value "Enabled"
Führen Sie den folgenden Befehl aus, um die Richtlinieneinstellung für einen bestimmten Angebotstyp eines Drittanbieters zu deaktivieren:
Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -OfferType <ID> -Value "Disabled"
Beispielskript zum Deaktivieren von AllowSelfServicePurchase
Im folgenden Beispiel erfahren Sie, wie Sie das MSCommerce-Modul importieren, sich mit Ihrem Konto anmelden, die ProductId für Power Automate pro Benutzer abrufen und dann AllowSelfServicePurchase für dieses Produkt deaktivieren.
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"
Wenn mehrere Werte für das Produkt vorhanden sind, können Sie den Befehl einzeln für jeden Wert ausführen, wie im folgenden Beispiel gezeigt:
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"}
Problembehandlung bei HandleError: Fehler beim Abrufen der Richtlinie mit der PolicyId "AllowSelfServicePurchase"
In einigen Fällen wird möglicherweise die folgende Fehlermeldung angezeigt:
HandleError: Fehler beim Abrufen der Richtlinie mit policyId "AllowSelfServicePurchase", ErrorMessage – Die zugrunde liegende Verbindung wurde geschlossen: Unerwarteter Fehler beim Senden.
Dieser Fehler kann auf eine ältere Version von Transport Layer Security (TLS) zurückzuführen sein. Wenn Sie eine Verbindung mit diesem Dienst herstellen, müssen Sie TLS 1.2 oder höher verwenden.
Führen Sie ein Upgrade auf TLS 1.2 durch, um diesen Fehler zu beheben. Die folgende Syntax aktualisiert das ServicePointManager-Sicherheitsprotokoll, um TLS1.2 zuzulassen:
[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
Weitere Informationen finden Sie unter Aktivieren von TLS 1.2.
Verwandte Inhalte
Verwalten von Self-Service-Käufen (Admin) (Artikel)
Häufig gestellte Fragen zum Self-Service-Kauf (Artikel)