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 .
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 leitor global do seu inquilino para ver uma lista só de leitura de políticas de produtos MSCommerce .
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 estado 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, o respetivo estado atual e como definir o estado. 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 o respetivo estado
Para ver uma lista de produtos Microsoft 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 para produtos Microsoft.
| Produto | ProductId | A versão de avaliação sem o método de pagamento está ativada? |
|---|---|---|
| Clipchamp Premium | CFQ7TTC0N8SS | Não |
| Microsoft 365 Copilot | CFQ7TTC0MM8R | Não |
| Microsoft 365 F3 | CFQ7TTC0LH05 | Não |
| Microsoft Purview Discovery | CFQ7TTC0N8SL | Sim |
| Power Apps por utilizador* | CFQ7TTC0LH2H | Não |
| Power Automate por utilizador* | CFQ7TTC0LH3L | Não |
| RPA do Power Automate* | CFQ7TTC0LSGZ | Não |
| Power BI Premium (autónomo)* | CFQ7TTC0H6RP | Não |
| Power BI Pro* | CFQ7TTC0H9MP | Não |
| Planner Plano 1* | CFQ7TTC0HDB1 | Sim |
| Project (Plano 3)* | CFQ7TTC0HDB0 | Não |
| Python no Excel | CFQ7TTC0S3X1 | Não |
| Exploratório do Teams | CFQ7TTC0J1FV | Sim |
| Preços introdutórios do Teams Premium | CFQ7TTC0RM8K | Sim |
| Visio (Plano 1)* | CFQ7TTC0HD33 | Sim |
| Visio (Plano 2)* | CFQ7TTC0HD32 | Não |
| Viva Goals (apenas avaliações self-service) | CFQ7TTC0PW0V | Sim |
*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 estado de 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 produtos Microsoft de compra self-service e o respetivo estado. Os utilizadores só podem comprar o produto após o fim da avaliação se AllowSelfServicePurchase estiver ativado.
Nota
Alterar o valor de AllowSelfServicePurchase ou OnlyTrialsWithoutPaymentMethod afeta apenas as avaliações ou compras efetuadas para o produto especificado a partir desse ponto. As versões de avaliação ou compras existentes do produto especificado não são afetadas.
A tabela seguinte descreve as definições do parâmetro Value .
| Definição | Resultado |
|---|---|
| Ativado | Os utilizadores podem fazer compras self-service e adquirir avaliações para o produto. |
| OnlyTrialsWithoutPaymentMethod | Os utilizadores não podem fazer compras self-service, mas podem adquirir avaliações gratuitas para produtos que não exigem que adicionem um método de pagamento. Após a expiração da versão de avaliação, um utilizador não pode comprar a versão paga do produto. |
| Desativado | Os utilizadores não podem fazer compras self-service nem adquirir avaliações para o produto. |
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 o respetivo estado e como definir o estado.
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 compra self-service disponíveis de terceiros 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.
| Tipo de Oferta | ID |
|---|---|
| Software como Serviço | SaaS |
| Elementos Visuais do Power BI | POWERBIVISUALS |
| Dynamics 365 Dataverse Apps | DYNAMICSCE |
| Dynamics 365 Business Central | DYNAMICSBC |
Ver ou definir o estado de 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 .
| Definição | Resultado |
|---|---|
| Ativado | Os utilizadores podem fazer compras self-service e adquirir avaliações para o produto. |
| Desativado | Os utilizadores não podem fazer compras self-service nem adquirir avaliações para o produto. |
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 resolver 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údos relacionados
Gerir compras self-service (Administração) (artigo)
FAQ sobre compras self-service (artigo)