Use AllowSelfServicePurchase para o módulo do MSCommerce PowerShell

O módulo MSCommerce PowerShell está disponível na 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ê também pode gerenciar as configurações de AllowSelfServicePurchase no Centro de administração do Microsoft 365. Para obter mais informações, consulte Gerenciar compras e avaliações de autoatendimento (para administradores).

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

• Exibir o estado padrão do valor do parâmetro AllowSelfServicePurchase
• Exibir uma lista de produtos aplicáveis e seu valor de parâmetro AllowSelfServicePurchase
• Exiba ou modifique a configuração atual de um produto específico para habilitá-lo ou desabilitá-lo
• Somente para produtos Microsoft: Exiba ou modifique a configuração para avaliações sem formas de pagamento

Requisitos

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

• Um sistema operacional Windows 10 ou posterior.
• A função de Administrador Global ou de Cobrança do locatário para alterar as políticas de produtos da MSCommerce .

  Cuidado

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

• A função de leitor global do seu locatário para ver uma lista somente leitura de políticas de produtos do MSCommerce .
• Parceiros que são administradores em nome de (AOBO) um cliente deve ter uma função definida como Administrador Global para gerenciar e desabilitar compras de autoatendimento no Centro de administração do Microsoft 365 e por meio do PowerShell.

Introdução ao módulo MSCommerce PowerShell

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

Instale o módulo MSCommerce PowerShell

Você instala o módulo MSCommerce PowerShell em seu dispositivo Windows 10 uma vez e, em seguida, importa-o para cada sessão do PowerShell que iniciar. Baixe o módulo MSCommerce PowerShell da Galeria do PowerShell.

Para instalar o módulo 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, importe-o para cada sessão do PowerShell iniciada. Para importá-lo para uma sessão do PowerShell, execute o seguinte comando:

Import-Module -Name MSCommerce

Conecte-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 do 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, use 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

Usar AllowSelfServicePurchase com produtos da Microsoft

Esta seção contém informações sobre como exibir uma lista de produtos da Microsoft para compra por autoatendimento, seu status atual e como definir o status. Para obter informações sobre tipos de oferta de terceiros, consulte Usar AllowSelfServicePurchase com tipos de oferta de terceiros.

Exibir uma lista de produtos de compra por autoatendimento da Microsoft e seu status

Para exibir uma lista de produtos Microsoft 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 suas ProductId. Ele também indica quais produtos têm uma avaliação disponível e não exigem uma forma de pagamento. Se aplicável, todas as outras avaliações exigem uma forma de pagamento. Para os produtos que têm a avaliação sem forma de pagamento habilitada, você pode habilitar a avaliação, mantendo a capacidade de comprar o produto desabilitada. Para obter comandos de exemplo, consulte Exibir ou definir o status de AllowSelfServicePurchase para produtos da Microsoft.

*Esses itens são IDs atualizados. Se você bloqueou produtos anteriormente usando as IDs antigas, eles serão automaticamente bloqueados usando as novas IDs. Nenhum outro trabalho é necessário.

Exiba ou defina o status de AllowSelfServicePurchase para produtos da 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. Você também pode usar o valor OnlyTrialsWithoutPaymentMethod para permitir que os usuários experimentem produtos que não têm avaliações obrigatórias para pagamento. Para ver quais produtos têm essas avaliações habilitadas, consulte a lista de produtos em Exibir uma lista de produtos de compra de autoatendimento da Microsoft e seu status. Os usuários só poderão comprar o produto após o término da avaliação se AllowSelfServicePurchase estiver habilitado.

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

Use os comandos a seguir para obter ou definir configurações de política, onde <ProductID> está a cadeia de caracteres associada ao nome do produto.

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

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

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

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

Para desabilitar a configuraçã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 usuários experimentem um produto específico sem uma forma de pagamento, execute o seguinte comando:

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

Usar AllowSelfServicePurchase com tipos de oferta de terceiros

Esta seção contém informações sobre como exibir uma lista de compras por autoatendimento para tipos de oferta de terceiros e seu status, e como definir o status.

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

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

Exibir ou definir o status 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 Valor .

Use os comandos a seguir para obter ou definir configurações de política, onde <ID> é a cadeia de caracteres associada ao tipo de oferta.

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 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 desabilitar AllowSelfServicePurchase

O exemplo a seguir mostra como importar o módulo MSCommerce , entrar com sua conta, obter a ProductId do Power Automate por usuário e, em seguida, desabilitar o 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:

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

Solucionar problemas de HandleError: falha ao recuperar a política com PolicyId 'AllowSelfServicePurchase'

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

Esse erro pode ser devido a uma versão mais antiga do protocolo TLS. Ao se conectar a esse serviço, você deverá usar o TLS 1.2 ou posterior.

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údo relacionado

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