Use AllowSelfServicePurchase para o módulo PowerShell MSCommerce

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

Também pode gerir as definições de AllowSelfServicePurchase no centro de administração do Microsoft 365. Para obter mais informações, consulte Gerenciar compras personalizadas e avaliações (para administradores).

Pode utilizar o módulo PowerShell do MSCommerce para:

• Exiba o estado padrão do valor do parâmetro AllowSelfServicePurchase
• Exibir uma lista de produtos aplicáveis e seu valor de parâmetro AllowSelfServicePurchase
• Ver ou modificar a definição atual de um produto específico para a 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 PowerShell do MSCommerce , precisa:

• Um sistema operativo Windows 10 ou posterior.
• A função de Administrador Global ou de Faturação do seu inquilino para alterar as políticas de produtos do MSCommerce .

  Atenção

  Os Administradores Globais têm acesso quase ilimitado às definições da sua organização e à maioria de seus 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 de Leitor global do seu inquilino para ver uma lista só de leitura das políticas de produtos MSCommerce .
• Parceiros que são Administradores Em Nome de (AOBO) um cliente tem de ter uma função definida como Administrador Global para poder gerir e desativar compras self-service no centro de administração do Microsoft 365 e através do PowerShell.

Introdução ao módulo PowerShell do MSCommerce

Para começar a usar o módulo PowerShell do MSCommerce , você deve instalá-lo, importá-lo para uma sessão do PowerShell e, em seguida, conectá-lo com suas credenciais.

Instalar o módulo PowerShell do MSCommerce

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

Para instalar o módulo PowerShell do MSCommerce 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

Ligue-se ao MSCommerce com as suas credenciais

Para ligar ao módulo 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 palavra-passe do inquilino a que pretende ligar-se. 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 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

Usar AllowSelfServicePurchase com produtos Microsoft

Esta secção contém informações sobre como ver uma lista de produtos Microsoft para compra personalizada, o estado atual e como definir o estado. Para obter informações sobre tipos de oferta de terceiros, consulte Usar AllowSelfServicePurchase com tipos de oferta de terceiros.

Ver uma lista de produtos Microsoft de compra personalizada e o respetivo estado

Para ver uma lista de produtos Microsoft de compra personalizada disponíveis e o estado de cada um, execute o seguinte comando:

Get-MSCommerceProductPolicies -PolicyId AllowSelfServicePurchase

A tabela a seguir lista os produtos disponíveis e seu ProductId. Também indica os produtos que têm uma versão de avaliação disponível e que não requerem um método de pagamento. Se aplicável, todas as outras avaliações exigem um método de pagamento. Para os produtos cuja versão de avaliação sem método de pagamento está ativada, pode ativar a avaliação enquanto mantém a capacidade de comprar o produto desativada. Para obter comandos de exemplo, consulte Exibir ou definir o status de AllowSelfServicePurchase para produtos Microsoft.

*Estes itens são IDs atualizados. Se anteriormente bloqueava produtos com os IDs antigos, estes são automaticamente bloqueados com os novos IDs. Não é necessário outro trabalho.

Ver ou definir o estado de AllowSelfServicePurchase para produtos Microsoft

Você pode definir o parâmetro Value para AllowSelfServicePurchase para permitir ou impedir que os usuários façam uma compra de autoatendimento de um produto da Microsoft. Também pode utilizar o valor OnlyTrialsWithoutPaymentMethod para permitir que os utilizadores experimentem produtos sem avaliação sem necessidade de pagamento. Para ver quais os produtos que têm estas versões de avaliação ativadas, consulte a lista de produtos em Ver uma lista de produtos Microsoft de compra personalizada e o respetivo estado. Os usuários só podem comprar o produto depois que a avaliação terminar se AllowSelfServicePurchase estiver habilitado.

A tabela a seguir descreve as configurações para o parâmetro Value .

Utilize os seguintes comandos para obter ou definir as definições de política, em que <ProductID> é a cadeia de carateres 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" 

Usar AllowSelfServicePurchase com tipos de oferta de terceiros

Esta secção contém informações sobre como ver uma lista de compra personalizada para tipos de oferta de terceiros e o respetivo estado, e como definir o estado.

Ver uma lista de compra personalizada, tipos de oferta de terceiros e o respetivo estado

Para exibir uma lista de todos os tipos de oferta de terceiros de compra personalizada disponíveis 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 a compra personalizada.

Ver ou definir o estado de AllowSelfServicePurchase para tipos de oferta de terceiros

Você pode definir o parâmetro Value para AllowSelfServicePurchase para permitir ou impedir que os usuários façam uma compra de autoatendimento de um tipo de oferta de terceiros.

A tabela a seguir descreve as configurações para o parâmetro Value .

Utilize os seguintes comandos para obter ou definir as definições de política, em que <ID> é a cadeia de carateres 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 mostra-lhe como importar o módulo MSCommerce , iniciar sessão com a sua conta, obter o ProductId do 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 múltiplos valores para o produto, pode executar o comando individualmente para cada valor, conforme apresentado 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"}

Troubleshoot HandleError: Failed to retrieve policy with PolicyId 'AllowSelfServicePurchase'

Em alguns casos, poderá ver a seguinte mensagem de erro:

HandleError : Falha ao recuperar política com PolicyId 'AllowSelfServicePurchase', ErrorMessage - A ligação subjacente foi fechada: Ocorreu um erro inesperado ao enviar.

Este erro pode ser devido a uma versão anterior do Transport Layer Security (TLS). Quando se ligar a este serviço, tem de utilizar o TLS 1.2 ou superior.

Para resolver esse erro, atualize para o 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, consulte Como habilitar o TLS 1.2.

Conteúdos relacionados

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