Utilizar AllowSelfServicePurchase para o módulo MSCommerce powerShell

O módulo MSCommerce do PowerShell está 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.

Também pode gerir as definições AllowSelfServicePurchase no Centro de administração do Microsoft 365. Para obter mais informações, veja Gerir compras e avaliações self-service (para administradores).

Pode utilizar o módulo MSCommerce do PowerShell para:

• Ver o estado predefinido do valor do parâmetro AllowSelfServicePurchase
• Ver uma lista dos produtos aplicáveis e o respetivo valor de parâmetro AllowSelfServicePurchase
• Ver ou modificar a definição atual de um produto específico para o ativar ou desativar
• Apenas para produtos Microsoft: 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.
• A função Administrador Global ou de Faturação do seu inquilino para alterar as políticas de produtos msCommerce .

  Cuidado

  Os Administradores Globais têm acesso quase ilimitado às definições da sua organização e à maioria dos respetivos dados. Para ajudar a manter a sua organização segura, recomendamos que limite o número de Administradores Globais o máximo possível.

• A função leitor global do seu inquilino para ver uma lista só de leitura de políticas de produtos MSCommerce .
• Os parceiros que são Administradores Em Nome de (AOBO) de um cliente têm de ter uma função definida como Administrador Global para gerir e desativar as compras self-service no Centro de administração do Microsoft 365 e através do PowerShell.

Introdução ao módulo msCommerce do PowerShell

Para começar a utilizar o módulo MSCommerce powerShell, tem de instalá-lo, importá-lo para uma sessão do PowerShell e, em seguida, ligar-se ao mesmo com as suas credenciais.

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 status predefinido, com base na sua organização, execute o seguinte comando:

Get-MSCommercePolicy -PolicyId AllowSelfServicePurchase

Utilizar AllowSelfServicePurchase com produtos Microsoft

Esta secção contém informações sobre como ver uma lista de produtos Microsoft para compra self-service, os respetivos status atuais e como definir o status. Para obter informações sobre tipos de oferta de terceiros, consulte Utilizar AllowSelfServicePurchase com tipos de oferta de terceiros.

Ver uma lista de compra personalizada de produtos Microsoft e os respetivos status

Para ver uma lista de produtos Microsoft de compra self-service disponíveis e o status 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 obter comandos de exemplo, consulte Ver ou definir o status para AllowSelfServicePurchase para produtos Microsoft.

*Estes itens são IDs atualizados. 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 ou definir o status para AllowSelfServicePurchase para produtos Microsoft

Pode definir o parâmetro Value para AllowSelfServicePurchase para permitir ou impedir que os utilizadores façam uma compra self-service de um produto Microsoft. Também pode utilizar o valor OnlyTrialsWithoutPaymentMethod para permitir que os utilizadores experimentem produtos que não tenham avaliações necessárias para pagamento. Para ver que produtos têm estas versões de avaliação ativadas, consulte a lista de produtos em Ver uma lista de compra personalizada de produtos Microsoft e os respetivos status. 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 .

Utilize os seguintes comandos para obter ou definir definições de política, em que <ProductID> é a cadeia associada ao nome do produto.

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

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

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

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

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

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

Utilizar AllowSelfServicePurchase com tipos de oferta de terceiros

Esta secção contém informações sobre como ver uma lista de compras self-service para tipos de oferta de terceiros e os respetivos status e como definir o status.

Ver uma lista de tipos de oferta de terceiros de compra self-service e os respetivos status

Para ver uma lista de todos os tipos de oferta de compra self-service disponíveis de terceiros e o status 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 status para AllowSelfServicePurchase para tipos de oferta de terceiros

Pode definir o parâmetro Value para AllowSelfServicePurchase para permitir ou impedir que os utilizadores efetuem uma compra self-service de um tipo de oferta de terceiros.

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

Utilize os seguintes comandos para obter ou definir definições de política, em que <ID> é a cadeia associada ao tipo de oferta.

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:

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

Resolver problemas do HandleError: Falha ao obter a política com o PolicyId "AllowSelfServicePurchase"

Em alguns casos, poderá 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.

Este erro 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.

Para resolve este erro, 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 (Administração) (artigo)
FAQ sobre compras self-service (artigo)