Utilizar AllowSelfServicePurchase para o módulo MSCommerce powerShell

O módulo MSCommerce do PowerShell está agora disponível na 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 iniciada. Transfira o módulo MSCommerce do PowerShell a partir da 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 do 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.

*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.

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.

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

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"

Soluçã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údo relacionado

Gerir compras self-service (Administrador) (artigo)
FAQ sobre compras self-service (artigo)