Utilizzare AllowSelfServicePurchase per il modulo PowerShell di MSCommerce

Il modulo di PowerShell MSCommerce è 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 in modalità self-service di Microsoft o selezionare offerte di terze parti.

È anche possibile gestire le impostazioni di AllowSelfServicePurchase nell'interfaccia di amministrazione di Microsoft 365. Per altre informazioni, vedere Gestire gli acquisti self-service e le versioni di valutazione (per gli amministratori).

È possibile usare il modulo di PowerShell di MSCommerce per:

• Visualizzare lo stato predefinito del valore del parametro AllowSelfServicePurchase
• Visualizzare un elenco di prodotti applicabili e il relativo valore del parametro AllowSelfServicePurchase
• Visualizzare o modificare l'impostazione corrente per un prodotto specifico per abilitarla o disabilitarla
• Solo per i prodotti Microsoft: visualizzare o modificare l'impostazione per le versioni di valutazione senza metodi di pagamento

Requisiti

Per usare il modulo PowerShell di MSCommerce , è necessario:

• Un sistema operativo Windows 10 o versione successiva.
• Il ruolo Amministratore globale o fatturazione per il tenant per modificare i criteri dei prodotti MSCommerce .

  Attenzione

  Gli amministratori globali hanno accesso quasi illimitato alle impostazioni dell'organizzazione e alla maggior parte dei suoi dati. Per proteggere l'organizzazione, è consigliabile limitare il più possibile il numero di amministratori globali.

• Il ruolo di lettore globale per il tenant per visualizzare un elenco di sola lettura dei criteri dei prodotti MSCommerce .
• Partner che sono amministratori per conto di (AOBO) Un cliente deve avere un ruolo impostato su Amministratore globale per gestire e disabilitare gli acquisti self-service nell'interfaccia di amministrazione di Microsoft 365 e tramite PowerShell.

Introduzione al modulo PowerShell di MSCommerce

Per iniziare a usare il modulo PowerShell di MSCommerce , è necessario installarlo, importarlo in una sessione di PowerShell e quindi connettersi con le credenziali.

Installare il modulo di PowerShell di MSCommerce

Si installa il modulo di PowerShell di MSCommerce nel dispositivo Windows 10 una volta e quindi lo si importa in ogni sessione di PowerShell avviata. Scaricare il modulo di PowerShell MSCommerce da PowerShell Gallery.

Per installare il modulo PowerShell di 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, è possibile importarlo in ogni sessione di PowerShell avviata. Per importarlo in una sessione di PowerShell, esegui 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 di Microsoft Entra. Il comando richiede di specificare il nome utente e la password per il tenant a cui connettersi. Se è abilitata l'autenticazione a più fattori per le credenziali, usare l'opzione interattiva per accedere.

Visualizzare i dettagli per AllowSelfServicePurchase

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

Get-MSCommercePolicy -PolicyId AllowSelfServicePurchase

Usare AllowSelfServicePurchase con i prodotti Microsoft

Questa sezione contiene informazioni su come visualizzare un elenco di prodotti Microsoft per l'acquisto self-service, il loro stato corrente e come impostare lo stato. Per informazioni sui tipi di offerta di terze parti, vedere Utilizzare AllowSelfServicePurchase con tipi di offerta di terze parti.

Visualizzare un elenco di prodotti Microsoft acquistati in modalità self-service e il relativo stato

Per visualizzare un elenco dei prodotti Microsoft disponibili per l'acquisto in modalità self-service e lo stato di ciascuno, eseguire il comando seguente:

Get-MSCommerceProductPolicies -PolicyId AllowSelfServicePurchase

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

*Questi articoli sono ID aggiornati. Se in precedenza i prodotti sono stati bloccati con i vecchi ID, questi vengono bloccati automaticamente con i nuovi ID. Non sono necessari altri lavori.

Visualizzare o impostare lo stato di AllowSelfServicePurchase per i prodotti Microsoft

È possibile impostare il parametro Value per AllowSelfServicePurchase per consentire o impedire agli utenti di effettuare un acquisto in modalità self-service di un prodotto Microsoft. È inoltre possibile utilizzare il valore di OnlyTrialsWithoutPaymentMethod per consentire agli utenti di provare prodotti che non hanno versioni di prova obbligatorie per il pagamento. Per visualizzare i prodotti per cui sono abilitate queste versioni di valutazione, vedi l'elenco dei prodotti in Visualizzare un elenco dei prodotti Microsoft acquistati in modalità self-service e il relativo stato. Gli utenti possono acquistare il prodotto solo al termine della versione di valutazione se AllowSelfServicePurchase è abilitato.

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

Usare i comandi seguenti per ottenere o configurare le impostazioni dei criteri, dove <ProductID> si trova la stringa associata al nome del prodotto.

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

Get-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId ```<ProductID>```

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

Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId <ProductID> -Value "Enabled"

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

Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId <ProductID> -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 <ProductID> -Value "OnlyTrialsWithoutPaymentMethod" 

Usare AllowSelfServicePurchase con tipi di offerta di terze parti

Questa sezione contiene informazioni su come visualizzare un elenco di acquisti self-service per tipi di offerte di terze parti e il loro stato, e su come impostare lo stato.

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

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

Get-MSCommerceProductPolicies -PolicyId AllowSelfServicePurchase -Scope OfferType

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

Visualizzare o impostare lo stato di AllowSelfServicePurchase per i tipi di offerta di terze parti

È possibile impostare il parametro Value per AllowSelfServicePurchase per consentire o impedire agli utenti di effettuare un acquisto self-service di un tipo di offerta di terze parti.

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

Usare i comandi seguenti per ottenere o configurare le impostazioni dei criteri, dove <ID> si trova la stringa associata al tipo di offerta.

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 il 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:

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"}

Risoluzione dei problemi HandleError: impossibile recuperare i criteri con PolicyId 'AllowSelfServicePurchase'

In alcuni casi, potrebbe essere visualizzato questo messaggio di errore:

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

Questo errore potrebbe essere dovuto a una versione precedente di Transport Layer Security (TLS). Quando ti connetti a questo servizio, devi usare TLS 1.2 o versione successiva.

Per risolvere questo errore, 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)