Usare AllowSelfServicePurchase per il modulo PowerShell MSCommerce

Il modulo PowerShell MSCommerce è ora disponibile in PowerShell Gallery. Il modulo include un valore del parametro PolicyID per AllowSelfServicePurchase che consente di controllare se gli utenti dell'organizzazione possono effettuare acquisti self-service di Microsoft o selezionare offerte di terze parti.

È possibile usare il modulo PowerShell MSCommerce per:

• Visualizzare lo stato predefinito del valore del parametro AllowSelfServicePurchase , indipendentemente dal fatto che sia abilitato, disabilitato o che consenta le versioni di valutazione senza un metodo di pagamento
• Visualizzare un elenco dei prodotti applicabili e verificare se l'acquisto self-service è abilitato, disabilitato o consente le versioni di valutazione senza un metodo di pagamento
• Visualizzare o modificare l'impostazione corrente per un prodotto specifico per abilitarla o disabilitarla
• Visualizzare o modificare l'impostazione per le versioni di valutazione senza metodi di pagamento

Requisiti

Per usare il modulo PowerShell MSCommerce , è necessario:

• Sistema operativo Windows 10 o versione successiva.
• PowerShell 5 o versione successiva. Attualmente PowerShell 6.x/7.x non è supportato con questo modulo.
• Ruolo di amministratore globale o di fatturazione per il tenant per modificare i criteri del prodotto MSCommerce .
• Ruolo lettore globale per il tenant per visualizzare un elenco di sola lettura dei criteri di prodotto MSCommerce .

Installare il modulo PowerShell MSCommerce

Installare il modulo MSCommerce PowerShell nel dispositivo Windows 10 una sola volta e quindi importarlo in ogni sessione di PowerShell avviata. Scaricare il modulo PowerShell MSCommerce dal PowerShell Gallery.

Per installare il modulo PowerShell MSCommerce con PowerShellGet, eseguire il comando seguente:

Install-Module -Name MSCommerce

Importare MSCommerce nella sessione di PowerShell

Dopo aver installato il modulo nel dispositivo Windows 10, importarlo in ogni sessione di PowerShell avviata. Per importarlo in una sessione di PowerShell, eseguire il comando seguente:

Import-Module -Name MSCommerce

Connettersi a MSCommerce con le credenziali

Per connettersi al modulo PowerShell con le credenziali, eseguire il comando seguente.

Connect-MSCommerce

Questo comando connette la sessione di PowerShell corrente a un tenant Microsoft Entra. Il comando richiede un nome utente e una password per il tenant a cui si vuole connettersi. Se l'autenticazione a più fattori è abilitata per le credenziali, usare l'opzione interattiva per accedere.

Visualizzare i dettagli per AllowSelfServicePurchase

Per visualizzare una descrizione del valore del parametro AllowSelfServicePurchase e dello stato predefinito, in base all'organizzazione, eseguire il comando seguente:

Get-MSCommercePolicy -PolicyId AllowSelfServicePurchase

Visualizzare un elenco dei prodotti di acquisto self-service e il relativo stato

Per visualizzare un elenco di tutti i prodotti di acquisto self-service disponibili e lo stato di ogni prodotto, eseguire il comando seguente:

Get-MSCommerceProductPolicies -PolicyId AllowSelfServicePurchase

Nella tabella seguente sono elencati i prodotti disponibili e il relativo ProductId. Indica anche quali prodotti hanno una versione di valutazione disponibile e non richiedono un metodo di pagamento. Se applicabile, tutte le altre versioni di valutazione richiedono un metodo di pagamento. Per i prodotti in cui è abilitata la versione di valutazione senza metodo di pagamento, è possibile abilitare la versione di valutazione, mantenendo la possibilità di acquistare il prodotto disabilitato. Per i comandi di esempio, vedere Visualizzare o impostare lo stato per AllowSelfServicePurchase.

Prodotto	Productid	La versione di valutazione senza metodo di pagamento è abilitata?
Clipchamp Premium	CFQ7TTC0N8SS	No
Power Apps per utente*	CFQ7TTC0LH2H	No
Power Automate per utente*	CFQ7TTC0LH3L	No
Power Automate RPA*	CFQ7TTC0LSGZ	No
Power BI Premium (autonomo)*	CFQ7TTC0H6RP	No
Power BI Pro*	CFQ7TTC0H9MP	No
Project - Piano 1*	CFQ7TTC0HDB1	Sì
Project - Piano 3*	CFQ7TTC0HDB0	No
Teams Exploratory	CFQ7TTC0J1FV	Sì
prezzi introduttivi Teams Premium	CFQ7TTC0RM8K	Sì
Visio - Piano 1*	CFQ7TTC0HD33	Sì
Visio - Piano 2*	CFQ7TTC0HD32	No
Viva Goals (solo versioni di valutazione self-service)	CFQ7TTC0PW0V	Sì
Windows 365 Enterprise	CFQ7TTC0HHS9	No
Windows 365 Business	CFQ7TTC0J203	No
Windows 365 Business con Vantaggio Windows Hybrid	CFQ7TTC0HX99	No
Microsoft 365 F3	CFQ7TTC0LH05	No
Individuazione di Microsoft Purview	CFQ7TTC0N8SL	Sì

*Questi ID sono stati modificati. Se in precedenza si bloccavano i prodotti che usavano gli ID precedenti, questi vengono automaticamente bloccati usando i nuovi ID. Non è necessario alcun altro lavoro.

Visualizzare un elenco di "tipi di offerta di terze parti" per l'acquisto self-service e il relativo stato

Per visualizzare un elenco di tutti i tipi di offerta di terze parti di acquisto self-service disponibili e lo stato di ognuno di essi, eseguire il comando seguente:

Get-MSCommerceProductPolicies -PolicyId AllowSelfServicePurchase -Scope OfferType

Nella tabella seguente sono elencati i tipi di offerta di terze parti disponibili. Questi tipi di offerta possono essere abilitati o disabilitati per l'acquisto self-service.

Tipo di offerta	Id
Software come servizio	SaaS
Oggetti visivi di Power BI	POWERBIVISUALS
Dynamics 365 app Dataverse	DYNAMICSCE
Dynamics 365 Business Central	DYNAMICSBC

Visualizzare o impostare lo stato per AllowSelfServicePurchase

È possibile impostare il parametro Value per AllowSelfServicePurchase per consentire o impedire agli utenti di effettuare un acquisto self-service. È anche possibile usare il valore OnlyTrialsWithoutPaymentMethod per consentire agli utenti di provare prodotti che non dispongono di versioni di valutazione necessarie per il pagamento. Fare riferimento all'elenco dei prodotti sopra riportato per vedere quali prodotti hanno abilitato queste versioni di valutazione. Gli utenti possono acquistare il prodotto solo dopo il termine della versione di valutazione se AllowSelfServicePurchase è abilitato.

Nota

La modifica del valore per AllowSelfServicePurchase o OnlyTrialsWithoutPaymentMethod influisce solo sulle versioni di valutazione o sugli acquisti effettuati per il prodotto specificato da quel punto in avanti. Le versioni di valutazione o gli acquisti esistenti per il prodotto specificato non sono interessati.

Nella tabella seguente vengono descritte le impostazioni per il parametro Value .

Impostazione	Impatto
Abilitato	Gli utenti possono effettuare acquisti self-service e acquisire versioni di valutazione per il prodotto.
OnlyTrialsWithoutPaymentMethod	Gli utenti non possono effettuare acquisti self-service, ma possono acquisire versioni di valutazione gratuite per i prodotti che non richiedono l'aggiunta di un metodo di pagamento. Dopo la scadenza della versione di valutazione, un utente non può acquistare la versione a pagamento del prodotto.
Disabilitato	Gli utenti non possono effettuare acquisti self-service o acquisire versioni di valutazione per il prodotto.

Per ottenere l'impostazione dei criteri per un prodotto specifico, eseguire il comando seguente:

Get-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId CFQ7TTC0KP0N

Per abilitare l'impostazione dei criteri per un prodotto specifico, eseguire il comando seguente:

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

Per disabilitare l'impostazione dei criteri per un prodotto specifico, eseguire il comando seguente:

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

Per consentire agli utenti di provare un prodotto specifico senza un metodo di pagamento, eseguire il comando seguente:

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

Per ottenere l'impostazione dei criteri per un tipo di offerta di terze parti specifico, eseguire il comando seguente:

Get-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -OfferType <ID>

Per abilitare l'impostazione dei criteri per un tipo di offerta di terze parti specifico, eseguire il comando seguente:

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

Per disabilitare l'impostazione dei criteri per un tipo di offerta di terze parti specifico, eseguire il comando seguente:

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

Script di esempio per disabilitare AllowSelfServicePurchase

L'esempio seguente illustra come importare il modulo MSCommerce , accedere con il proprio account, ottenere productid per Power Automate per utente e quindi disabilitare AllowSelfServicePurchase per tale prodotto.

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"

Se sono presenti più valori per il prodotto, è possibile eseguire il comando singolarmente per ogni valore, come illustrato nell'esempio seguente:

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"

Risoluzione dei problemi

Problema

Viene visualizzato il messaggio di errore seguente:

HandleError: impossibile recuperare i criteri con PolicyId 'AllowSelfServicePurchase', ErrorMessage: la connessione sottostante è stata chiusa: si è verificato un errore imprevisto durante un'invio.

Ciò può essere dovuto a una versione precedente di Transport Layer Security (TLS). Quando ci si connette a questo servizio, è necessario usare TLS 1.2 o versione successiva

Soluzione

Eseguire l'aggiornamento a TLS 1.2. La sintassi seguente aggiorna il protocollo di sicurezza ServicePointManager per consentire TLS1.2:

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

Per altre informazioni, vedere Come abilitare TLS 1.2.

Contenuto correlato

Gestire gli acquisti self-service (Amministrazione) (articolo)
Domande frequenti sugli acquisti self-service (articolo)