Utilizar AllowSelfServicePurchase para o módulo MSCommerce powerShell

O módulo MSCommerce do PowerShell está agora disponível no Galeria do PowerShell. O módulo inclui um valor de parâmetro PolicyID para AllowSelfServicePurchase que lhe permite controlar se os utilizadores na sua organização podem fazer compras self-service da Microsoft ou selecionar ofertas de terceiros.

Pode utilizar o módulo MSCommerce do PowerShell para:

• Ver o estado predefinido do valor do parâmetro AllowSelfServicePurchase — quer esteja ativado, desativado ou permita avaliações sem um método de pagamento
• Ver uma lista de produtos aplicáveis e se a compra self-service está ativada, desativada ou permite avaliações sem um método de pagamento
• Ver ou modificar a definição atual de um produto específico para o ativar ou desativar
• Ver ou modificar a definição de avaliações sem métodos de pagamento

Requisitos

Para utilizar o módulo MSCommerce do PowerShell, precisa de:

• Um sistema operativo Windows 10 ou posterior.
• PowerShell 5 ou inferior. Atualmente, o PowerShell 6.x/7.x não é suportado neste módulo.
• A função de administrador Global ou de Faturação para o seu inquilino alterar as políticas de produto msCommerce .
• A função leitor global do seu inquilino para ver uma lista só de leitura de políticas de produtos MSCommerce .

Instalar o módulo msCommerce do PowerShell

Instale o módulo MSCommerce PowerShell no seu dispositivo Windows 10 uma vez e, em seguida, importe-o para cada sessão do PowerShell que iniciar. Transfira o módulo MSCommerce do PowerShell a partir do Galeria do PowerShell.

Para instalar o módulo MSCommerce do PowerShell com o PowerShellGet, execute o seguinte comando:

Install-Module -Name MSCommerce

Importar o MSCommerce para a sessão do PowerShell

Depois de instalar o módulo no seu dispositivo Windows 10, importe-o para cada sessão do PowerShell que iniciar. Para importá-lo para uma sessão do PowerShell, execute o seguinte comando:

Import-Module -Name MSCommerce

Ligar ao MSCommerce com as suas credenciais

Para ligar ao módulo do PowerShell com as suas credenciais, execute o seguinte comando.

Connect-MSCommerce

Este comando liga a sessão atual do PowerShell a um inquilino Microsoft Entra. O comando pede-lhe um nome de utilizador e uma palavra-passe para o inquilino ao qual pretende ligar. Se a autenticação multifator estiver ativada para as suas credenciais, utilize a opção interativa para iniciar sessão.

Ver detalhes de AllowSelfServicePurchase

Para ver uma descrição do valor do parâmetro AllowSelfServicePurchase e o estado predefinido, com base na sua organização, execute o seguinte comando:

Get-MSCommercePolicy -PolicyId AllowSelfServicePurchase

Ver uma lista de produtos de compra self-service e o respetivo estado

Para ver uma lista de todos os produtos de compra self-service disponíveis e o estado de cada um, execute o seguinte comando:

Get-MSCommerceProductPolicies -PolicyId AllowSelfServicePurchase

A tabela seguinte lista os produtos disponíveis e o ProductId. Também indica que produtos têm uma avaliação disponível e não requerem um método de pagamento. Se aplicável, todas as outras versões de avaliação requerem um método de pagamento. Para os produtos que têm a versão de avaliação sem o método de pagamento ativado, pode ativar a versão de avaliação, mantendo a capacidade de comprar o produto desativado. Para comandos de exemplo, consulte Ver ou definir o estado de AllowSelfServicePurchase.

Produto	ProductId	A versão de avaliação sem o método de pagamento está ativada?
Clipchamp Premium	CFQ7TTC0N8SS	Não
Power Apps por utilizador*	CFQ7TTC0LH2H	Não
Power Automate por utilizador*	CFQ7TTC0LH3L	Não
RPA do Power Automate*	CFQ7TTC0LSGZ	Não
Power BI Premium (autónomo)*	CFQ7TTC0H6RP	Não
Power BI Pro*	CFQ7TTC0H9MP	Não
Project (Plano 1)*	CFQ7TTC0HDB1	Sim
Project (Plano 3)*	CFQ7TTC0HDB0	Não
Exploratório do Teams	CFQ7TTC0J1FV	Sim
Preços introdutórios do Teams Premium	CFQ7TTC0RM8K	Sim
Visio (Plano 1)*	CFQ7TTC0HD33	Sim
Visio (Plano 2)*	CFQ7TTC0HD32	Não
Viva Goals (apenas avaliações self-service)	CFQ7TTC0PW0V	Sim
Windows 365 Enterprise	CFQ7TTC0HHS9	Não
Windows 365 Business	CFQ7TTC0J203	Não
Windows 365 Business com Benefício Híbrido do Windows	CFQ7TTC0HX99	Não
Microsoft 365 F3	CFQ7TTC0LH05	Não
Microsoft Purview Discovery	CFQ7TTC0N8SL	Sim

*Estes IDs foram alterados. Se bloqueou anteriormente os produtos com os IDs antigos, estes são automaticamente bloqueados através dos novos IDs. Não é necessário mais nenhum trabalho.

Ver uma lista de "tipos de oferta de terceiros" de compra self-service e o respetivo estado

Para ver uma lista de todos os tipos de oferta de terceiros de compra self-service disponíveis e o estado de cada um, execute o seguinte comando:

Get-MSCommerceProductPolicies -PolicyId AllowSelfServicePurchase -Scope OfferType

A tabela seguinte lista os tipos de oferta de terceiros disponíveis. Estes tipos de oferta podem ser ativados ou desativados para compra self-service.

Tipo de Oferta	ID
Software como Serviço	SaaS
Elementos Visuais do Power BI	POWERBIVISUALS
Dynamics 365 Dataverse Apps	DYNAMICSCE
Dynamics 365 Business Central	DYNAMICSBC

Ver ou definir o estado de AllowSelfServicePurchase

Pode definir o parâmetro Value para AllowSelfServicePurchase para permitir ou impedir que os utilizadores façam uma compra self-service. Também pode utilizar o valor OnlyTrialsWithoutPaymentMethod para permitir que os utilizadores experimentem produtos que não tenham avaliações necessárias para pagamento. Veja a lista de produtos acima para ver que produtos têm estas versões de avaliação ativadas. Os utilizadores só podem comprar o produto após o fim da avaliação se AllowSelfServicePurchase estiver ativado.

Nota

Alterar o valor de AllowSelfServicePurchase ou OnlyTrialsWithoutPaymentMethod afeta apenas as avaliações ou compras efetuadas para o produto especificado a partir desse ponto. As versões de avaliação ou compras existentes do produto especificado não são afetadas.

A tabela seguinte descreve as definições do parâmetro Value .

Definição	Impacto
Ativado	Os utilizadores podem fazer compras self-service e adquirir avaliações para o produto.
OnlyTrialsWithoutPaymentMethod	Os utilizadores não podem fazer compras self-service, mas podem adquirir avaliações gratuitas para produtos que não exigem que adicionem um método de pagamento. Após a expiração da versão de avaliação, um utilizador não pode comprar a versão paga do produto.
Desativado	Os utilizadores não podem fazer compras self-service nem adquirir avaliações para o produto.

Para obter a definição de política para um produto específico, execute o seguinte comando:

Get-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId CFQ7TTC0KP0N

Para ativar a definição de política para um produto específico, execute o seguinte comando:

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

Para desativar a definição de política para um produto específico, execute o seguinte comando:

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

Para permitir que os utilizadores experimentem um produto específico sem um método de pagamento, execute o seguinte comando:

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

Para obter a definição de política para um tipo de oferta de terceiros específico, execute o seguinte comando:

Get-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -OfferType <ID>

Para ativar a definição de política para um tipo de oferta de terceiros específico, execute o seguinte comando:

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

Para desativar a definição de política para um tipo de oferta de terceiros específico, execute o seguinte comando:

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

Script de exemplo para desativar AllowSelfServicePurchase

O exemplo seguinte explica como importar o módulo MSCommerce , iniciar sessão com a sua conta, obter o ProductId para o Power Automate por utilizador e, em seguida, desativar AllowSelfServicePurchase para esse produto.

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 existirem vários valores para o produto, pode executar o comando individualmente para cada valor, conforme mostrado no exemplo seguinte:

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"

Resolução de Problemas

Problema

Verá a seguinte mensagem de erro:

HandleError: Falha ao obter a política com PolicyId "AllowSelfServicePurchase", ErrorMessage – A ligação subjacente foi fechada: ocorreu um erro inesperado num envio.

Isto pode dever-se a uma versão mais antiga do Transport Layer Security (TLS). Quando se liga a este serviço, tem de utilizar o TLS 1.2 ou superior

Solução

Atualize para o TLS 1.2. A sintaxe seguinte atualiza o Protocolo de Segurança do ServicePointManager para permitir o TLS1.2:

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

Para saber mais, veja Como ativar o TLS 1.2.

Conteúdos relacionados

Gerir compras self-service (Administração) (artigo)
FAQ sobre compras self-service (artigo)