Verwenden von AllowSelfServicePurchase für das MSCommerce-PowerShell-ModulUse AllowSelfServicePurchase for the MSCommerce PowerShell module

Das MSCommerce PowerShell-Modul steht nun im PowerShell-Katalogzur Verfügung.The MSCommerce PowerShell module is now available on PowerShell Gallery. Das Modul enthält einen Parameterwert für die Richtlinien - AllowSelfServicePurchase , mit dem Sie steuern können, ob Benutzer in Ihrer Organisation Self-Service-Käufe tätigen können.The module includes a PolicyID parameter value for AllowSelfServicePurchase that lets you control whether users in your organization can make self-service purchases.

Sie können das MSCommerce -PowerShell-Modul verwenden, um Folgendes zu tun:You can use the MSCommerce PowerShell module to:

  • Anzeigen des Standardstatus des AllowSelfServicePurchase -Parameterwerts – unabhängig davon, ob er aktiviert oder deaktiviert istView the default state of the AllowSelfServicePurchase parameter value — whether it's enabled or disabled
  • Anzeigen einer Liste der anwendbaren Produkte und der Aktivierung oder Deaktivierung von Self-Service-KäufenView a list of applicable products and whether self-service purchase is enabled or disabled
  • Anzeigen oder Ändern der aktuellen Einstellung für ein bestimmtes Produkt, um es entweder zu aktivieren oder zu deaktivierenView or modify the current setting for a specific product to either enable or disable it

AnforderungenRequirements

Um das MSCommerce PowerShell-Modul verwenden zu können, benötigen Sie Folgendes:To use the MSCommerce PowerShell module, you need:

  • Ein Windows 10-GerätA Windows 10 device
  • Administrator Berechtigung für das GerätAdministrator permission for the device
  • Globale oder abrechnungsadministrator Rolle für Ihren MandantenGlobal or Billing Admin role for your tenant

Installieren des MSCommerce PowerShell-ModulsInstall the MSCommerce PowerShell module

Sie installieren das MSCommerce PowerShell-Modul auf Ihrem Windows 10-Gerät einmal und importieren es dann in jede von Ihnen gestartete PowerShell-Sitzung.You install the MSCommerce PowerShell module on your Windows 10 device once and then import it into each PowerShell session you start. Laden Sie das MSCommerce PowerShell-Modul aus dem PowerShell-Katalogherunter.Download the MSCommerce PowerShell module from the PowerShell Gallery.

Führen Sie den folgenden Befehl aus, um das MSCommerce PowerShell-Modul mit PowerShellGetzu installieren:To install the MSCommerce PowerShell module with PowerShellGet, run the following command:

Install-Module -Name MSCommerce

Importieren von MSCommerce in die PowerShell-SitzungImport MSCommerce into the PowerShell session

Nachdem Sie das Modul auf Ihrem Windows 10-Gerät installiert haben, importieren Sie es in jede PowerShell-Sitzung, die Sie starten.After you install the module on your Windows 10 device, you then import it into each PowerShell session that you start. Führen Sie den folgenden Befehl aus, um ihn in eine PowerShell-Sitzung zu importieren:To import it into a PowerShell session, run the following command:

Import-Module -Name MSCommerce

Herstellen einer Verbindung mit MSCommerce mit Ihren AnmeldeinformationenConnect to MSCommerce with your credentials

Führen Sie den folgenden Befehl aus, um eine Verbindung mit dem PowerShell-Modul mit Ihren Anmeldeinformationen herzustellen.To connect to the PowerShell module with your credentials, run the following command.

Connect-MSCommerce

Mit diesem Befehl wird die aktuelle PowerShell-Sitzung mit einem Azure-Active Directory-Mandanten verbunden.This command connects the current PowerShell session to an Azure Active Directory tenant. Mit dem Befehl werden Sie aufgefordert, einen Benutzernamen und ein Kennwort für den Mandanten einzugeben, mit dem Sie eine Verbindung herstellen möchten.The command prompts you for a username and password for the tenant you want to connect to. Wenn die mehrstufige Authentifizierung für Ihre Anmeldeinformationen aktiviert ist, verwenden Sie die interaktive Option, um sich anzumelden.If multi-factor authentication is enabled for your credentials, you use the interactive option to log in.

Anzeigen von Details für AllowSelfServicePurchaseView details for AllowSelfServicePurchase

Führen Sie den folgenden Befehl aus, um eine Beschreibung des AllowSelfServicePurchase -Parameterwerts und des Standardstatus basierend auf Ihrer Organisation anzuzeigen:To view a description of the AllowSelfServicePurchase parameter value and the default status, based on your organization, run the following command:

Get-MSCommercePolicy -PolicyId AllowSelfServicePurchase

Anzeigen einer Liste von Self-Service-Kauf Produkten und deren StatusView a list of self-service purchase products and their status

Führen Sie den folgenden Befehl aus, um eine Liste aller verfügbaren Self-Service-Einkaufsprodukte und den jeweiligen Status anzuzeigen:To view a list of all available self-service purchase products and the status of each, run the following command:

Get-MSCommerceProductPolicies -PolicyId AllowSelfServicePurchase

In der folgenden Tabelle sind die verfügbaren Produkte und deren ProductIDaufgeführt.The following table lists the available products and their ProductId.

ProduktProduct ProductIDProductId
Power-apps pro BenutzerPower Apps per user CFQ7TTC0KP0PCFQ7TTC0KP0P
Power-Automatisierung pro BenutzerPower Automate per user CFQ7TTC0KP0NCFQ7TTC0KP0N
Power BI ProPower BI Pro CFQ7TTC0L3PBCFQ7TTC0L3PB
Projekt Plan 1Project Plan 1 CFQ7TTC0KXNDCFQ7TTC0KXND
Projekt Plan 3Project Plan 3 CFQ7TTC0KXNCCFQ7TTC0KXNC
Visio-Plan 1Visio Plan 1 CFQ7TTC0KXN9CFQ7TTC0KXN9
Visio-Plan 2Visio Plan 2 CFQ7TTC0KXN8CFQ7TTC0KXN8

Anzeigen oder Festlegen des Status für AllowSelfServicePurchaseView or set the status for AllowSelfServicePurchase

Nachdem Sie die Liste der Produkte angezeigt haben, die für Self-Service-Einkauf verfügbar sind, können Sie die Einstellung für ein bestimmtes Produkt anzeigen oder ändern.After you view the list of products available for self-service purchase, you can view or modify the setting for a specific product.

Um die Richtlinieneinstellung für ein bestimmtes Produkt abzurufen, führen Sie den folgenden Befehl aus:To get the policy setting for a specific product, run the following command:

Get-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId CFQ7TTC0KP0N

Führen Sie den folgenden Befehl aus, um die Richtlinieneinstellung für ein bestimmtes Produkt zu aktivieren:To enable the policy setting for a specific product, run the following command:

Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId CFQ7TTC0KP0N -Enabled $True

Führen Sie den folgenden Befehl aus, um die Richtlinieneinstellung für ein bestimmtes Produkt zu deaktivieren:To disable the policy setting for a specific product, run the following command:

Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId CFQ7TTC0KP0N -Enabled $False

Beispielskript zum Deaktivieren von AllowSelfServicePurchaseExample script to disable AllowSelfServicePurchase

Im folgenden Beispiel wird erläutert, wie Sie das MSCommerce -Modul importieren, sich mit Ihrem Konto anmelden, die ProductID für Power automatisieren und dann AllowSelfServicePurchase für dieses Produkt deaktivieren.The following example walks you through how to import the MSCommerce module, sign in with your account, get the ProductId for Power Automate, and then disable AllowSelfServicePurchase for that product.

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'}
Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId $product.ProductID -Enabled $false

ProblembehandlungTroubleshooting

ProblemProblem

Die folgende Fehlermeldung wird angezeigt:You see the following error message:

HandleError: Fehler beim Abrufen einer Richtlinie mit der Richtlinien-Nr "AllowSelfServicePurchase", ErrorMessage – die zugrunde liegende Verbindung wurde geschlossen: ein unerwarteter Fehler ist bei einem senden aufgetreten.HandleError : Failed to retrieve policy with PolicyId 'AllowSelfServicePurchase', ErrorMessage - The underlying connection was closed: An unexpected error occurred on a send.

Dies kann an einer älteren Version von Transport Layer Security (TLS) liegen.This may be due to an older version of Transport Layer Security (TLS). Um diesen Dienst zu verbinden, müssen Sie TLS 1,2 oder höher verwenden.To connect this service you need to use TLS 1.2 or greater

LösungSolution

Upgrade auf TLS 1,2: https://docs.microsoft.com/mem/configmgr/core/plan-design/security/enable-tls-1-2Upgrade to TLS 1.2: https://docs.microsoft.com/mem/configmgr/core/plan-design/security/enable-tls-1-2