Usare AllowSelfServicePurchase per il modulo PowerShell MSCommerce

Il modulo PowerShell MSCommerce è disponibile nel 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.

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

È possibile usare il modulo PowerShell 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 MSCommerce , è necessario:

• Sistema operativo Windows 10 o versione successiva.
• Ruolo Amministratore globale o di fatturazione per il tenant per modificare i criteri del prodotto MSCommerce .

  Attenzione

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

• Ruolo lettore globale per il tenant per visualizzare un elenco di sola lettura dei criteri di prodotto MSCommerce .
• I 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 nel interfaccia di amministrazione di Microsoft 365 e tramite PowerShell.

Introduzione al modulo PowerShell MSCommerce

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

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

Usare AllowSelfServicePurchase con i prodotti Microsoft

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

Visualizzare un elenco di prodotti Microsoft per l'acquisto self-service e il relativo stato

Per visualizzare un elenco dei prodotti Microsoft 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 per i prodotti Microsoft.

*Questi elementi sono ID aggiornati. 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 o impostare lo stato per AllowSelfServicePurchase per i prodotti Microsoft

È possibile impostare il parametro Value per AllowSelfServicePurchase per consentire o impedire agli utenti di effettuare un acquisto self-service di un prodotto Microsoft. È anche possibile usare il valore OnlyTrialsWithoutPaymentMethod per consentire agli utenti di provare prodotti che non dispongono di versioni di valutazione necessarie per il pagamento. Per vedere quali prodotti hanno abilitato queste versioni di valutazione, vedere l'elenco dei prodotti in Visualizzare un elenco di prodotti Microsoft per l'acquisto self-service e il relativo stato. Gli utenti possono acquistare il prodotto solo dopo il 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 impostare le impostazioni dei criteri, dove <ProductID> è 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 i tipi di offerta di terze parti e il relativo stato e su come impostare lo stato.

Visualizzare un elenco dei 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.

Visualizzare o impostare lo stato per 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 impostare le impostazioni dei criteri, dove <ID> è 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 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"}

Risolvere i problemi relativi a HandleError: impossibile recuperare i criteri con PolicyId 'AllowSelfServicePurchase'

In alcuni casi, potrebbe essere 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.

Questo errore potrebbe 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.

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)