Usar AllowSelfServicePurchase para o módulo do MSCommerce PowerShell

O módulo do MSCommerce PowerShell já está disponível no Galeria do PowerShell. O módulo inclui um valor de parâmetro PolicyID para AllowSelfServicePurchase que permite controlar se os usuários em sua organização podem fazer compras de autoatendimento da Microsoft ou selecionar ofertas de terceiros.

Você pode usar o módulo do MSCommerce PowerShell para:

• Exiba o estado padrão do valor do parâmetro AllowSelfServicePurchase – se ele está habilitado, desabilitado ou permite avaliações sem um método de pagamento
• Exibir uma lista de produtos aplicáveis e se a compra por autoatendimento está habilitada, desabilitada ou permite avaliações sem um método de pagamento
• Exibir ou modificar a configuração atual de um produto específico para habilitá-lo ou desabilitá-lo
• Exibir ou modificar a configuração para avaliações sem métodos de pagamento

Requisitos

Para usar o módulo do MSCommerce PowerShell, você precisa:

• Um sistema operacional Windows 10 ou posterior.
• PowerShell 5 ou abaixo. Atualmente, o PowerShell 6.x/7.x não tem suporte com este módulo.
• A função de administrador global ou de cobrança para que seu locatário altere as políticas de produto MSCommerce .
• A função de leitor global para seu locatário para ver uma lista somente leitura de políticas de produto MSCommerce .

Instalar o módulo do MSCommerce PowerShell

Instale o módulo do MSCommerce PowerShell em seu dispositivo Windows 10 uma vez e, em seguida, importe-o para cada sessão do PowerShell iniciada. Baixe o módulo do MSCommerce PowerShell do Galeria do PowerShell.

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

Install-Module -Name MSCommerce

Importar MSCommerce para a sessão do PowerShell

Depois de instalar o módulo em seu dispositivo Windows 10, você o importará para cada sessão do PowerShell iniciada. Para importá-lo em uma sessão do PowerShell, execute o seguinte comando:

Import-Module -Name MSCommerce

Conectar-se ao MSCommerce com suas credenciais

Para se conectar ao módulo do PowerShell com suas credenciais, execute o comando a seguir.

Connect-MSCommerce

Esse comando conecta a sessão atual do PowerShell a um locatário Microsoft Entra. O comando solicita um nome de usuário e uma senha para o locatário ao qual você deseja se conectar. Se a autenticação multifator estiver habilitada para suas credenciais, você usará a opção interativa para entrar.

Exibir detalhes de AllowSelfServicePurchase

Para exibir uma descrição do valor do parâmetro AllowSelfServicePurchase e o status padrão, com base em sua organização, execute o seguinte comando:

Get-MSCommercePolicy -PolicyId AllowSelfServicePurchase

Exibir uma lista de produtos de compra por autoatendimento e seus status

Para exibir uma lista de todos os produtos de compra por autoatendimento disponíveis e o status de cada um, execute o seguinte comando:

Get-MSCommerceProductPolicies -PolicyId AllowSelfServicePurchase

A tabela a seguir lista os produtos disponíveis e seus ProductId. Ele também indica quais produtos têm uma avaliação disponível e não exigem um método de pagamento. Se aplicável, todas as outras avaliações exigem um método de pagamento. Para os produtos que têm a avaliação sem a forma de pagamento habilitada, você pode habilitar a avaliação, mantendo a capacidade de comprar o produto desabilitado. Para comandos de exemplo, consulte Exibir ou definir o status para AllowSelfServicePurchase.

Produto	Productid	A avaliação sem método de pagamento está habilitada?
Clipchamp Premium	CFQ7TTC0N8SS	Não
Power Apps por usuário*	CFQ7TTC0LH2H	Não
Power Automate por usuário*	CFQ7TTC0LH3L	Não
Power Automate RPA*	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 Teams Premium	CFQ7TTC0RM8K	Sim
Visio Plano 1*	CFQ7TTC0HD33	Sim
Visio Plano 2*	CFQ7TTC0HD32	Não
Viva Goals (somente avaliações de autoatendimento)	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
Descoberta do Microsoft Purview	CFQ7TTC0N8SL	Sim

*Essas IDs foram alteradas. Se você bloqueou produtos anteriormente usando as IDs antigas, eles serão bloqueados automaticamente usando as novas IDs. Nenhum outro trabalho é necessário.

Exibir uma lista de "tipos de oferta de terceiros" de compra por autoatendimento e seus status

Para exibir uma lista de todos os tipos de oferta de terceiros de compra por autoatendimento disponíveis e o status de cada um, execute o seguinte comando:

Get-MSCommerceProductPolicies -PolicyId AllowSelfServicePurchase -Scope OfferType

A tabela a seguir lista os tipos de oferta de terceiros disponíveis. Esses tipos de oferta podem ser habilitados ou desabilitados para compra por autoatendimento.

Tipo de Oferta	Id
Software como serviço	SaaS
Visuais do Power BI	POWERBIVISUALS
Dynamics 365 Aplicativos do Dataverse	DYNAMICSCE
Dynamics 365 Business Central	DYNAMICSBC

Exibir ou definir o status para AllowSelfServicePurchase

Você pode definir o parâmetro Value para AllowSelfServicePurchase para permitir ou impedir que os usuários façam uma compra de autoatendimento. Você também pode usar o valor OnlyTrialsWithoutPaymentMethod para permitir que os usuários experimentem produtos que não tenham avaliações necessárias para pagamento. Consulte a lista de produtos acima para ver quais produtos têm essas avaliações habilitadas. Os usuários só poderão comprar o produto após o fim da avaliação se AllowSelfServicePurchase estiver habilitado.

Observação

Alterar o valor de AllowSelfServicePurchase ou OnlyTrialsWithoutPaymentMethod afeta apenas as avaliações ou compras feitas para o produto especificado desse ponto em diante. As avaliações ou compras existentes para o produto especificado não são afetadas.

A tabela a seguir descreve as configurações do parâmetro Valor .

Configuração	Impacto
Habilitado	Os usuários podem fazer compras de autoatendimento e adquirir avaliações para o produto.
OnlyTrialsWithoutPaymentMethod	Os usuários não podem fazer compras de autoatendimento, mas podem adquirir avaliações gratuitas para produtos que não exigem que eles adicionem um método de pagamento. Depois que a avaliação expirar, um usuário não poderá comprar a versão paga do produto.
Desabilitado	Os usuários não podem fazer compras de autoatendimento ou adquirir avaliações para o produto.

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

Get-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId CFQ7TTC0KP0N

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

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

Para desabilitar a configuração de política de um produto específico, execute o seguinte comando:

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

Para permitir que os usuários 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 configuração de política para um tipo de oferta de terceiros específico, execute o seguinte comando:

Get-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -OfferType <ID>

Para habilitar a configuraçã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 desabilitar a configuração da 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 desabilitar AllowSelfServicePurchase

O exemplo a seguir orienta como importar o módulo MSCommerce , entrar com sua conta, obter o ProductId para Power Automate por usuário e desabilitar 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 houver vários valores para o produto, você poderá executar o comando individualmente para cada valor, conforme mostrado no exemplo a seguir:

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

Você verá a seguinte mensagem de erro:

HandleError : falha ao recuperar a política com PolicyId 'AllowSelfServicePurchase', ErrorMessage - A conexão subjacente foi fechada: ocorreu um erro inesperado em um envio.

Isso pode ser devido a uma versão mais antiga do TLS (Transport Layer Security). Ao se conectar a esse serviço, você deve usar o TLS 1.2 ou superior

Solução

Atualize para TLS 1.2. A sintaxe a seguir atualiza o Protocolo de Segurança servicePointManager para permitir TLS1.2:

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

Para saber mais, confira Como habilitar o TLS 1.2.

Conteúdo relacionado

Gerenciar compras de autoatendimento (Administração) (artigo)
Perguntas frequentes sobre compra por autoatendimento (artigo)