Uso de AllowSelfServicePurchase para el módulo de PowerShell MSCommerce

El módulo de PowerShell MSCommerce está disponible en el Galería de PowerShell. El módulo incluye un valor de parámetro PolicyID para AllowSelfServicePurchase que le permite controlar si los usuarios de su organización pueden realizar compras de autoservicio de Microsoft o seleccionar ofertas de terceros.

También puede administrar la configuración de AllowSelfServicePurchase en el Centro de administración de Microsoft 365. Para obtener más información, consulte Administración de compras y pruebas de autoservicio (para administradores).

Puede usar el módulo de PowerShell MSCommerce para:

• Ver el estado predeterminado del valor del parámetro AllowSelfServicePurchase
• Ver una lista de productos aplicables y su valor de parámetro AllowSelfServicePurchase
• Ver o modificar la configuración actual de un producto específico para habilitarlo o deshabilitarlo
• Solo para productos de Microsoft: vea o modifique la configuración de las pruebas sin métodos de pago.

Requisitos

Para usar el módulo de PowerShell MSCommerce , necesita:

• Un sistema operativo Windows 10 o posterior.
• El rol Administrador global o de facturación para que el inquilino cambie las directivas de producto de MSCommerce .

  Precaución

  Los administradores globales tienen acceso casi ilimitado a la configuración de la organización y a la mayoría de sus datos. Para ayudar a mantener la seguridad de su organización, se recomienda limitar el número de administradores globales tanto como sea posible.

• Rol lector global para que el inquilino vea una lista de solo lectura de directivas de producto de MSCommerce .

Introducción al módulo de PowerShell MSCommerce

Para empezar a usar el módulo de PowerShell MSCommerce , debe instalarlo, importarlo en una sesión de PowerShell y, a continuación, conectarse a él con sus credenciales.

Instalación del módulo de PowerShell MSCommerce

Instale el módulo de PowerShell MSCommerce en el dispositivo Windows 10 una vez y, a continuación, impórtelo en cada sesión de PowerShell que inicie. Descargue el módulo de PowerShell MSCommerce desde el Galería de PowerShell.

Para instalar el módulo de PowerShell MSCommerce con PowerShellGet, ejecute el siguiente comando:

Install-Module -Name MSCommerce

Importación de MSCommerce en la sesión de PowerShell

Después de instalar el módulo en el dispositivo Windows 10, lo importa en cada sesión de PowerShell que inicie. Para importarlo en una sesión de PowerShell, ejecute el siguiente comando:

Import-Module -Name MSCommerce

Conexión a MSCommerce con sus credenciales

Para conectarse al módulo de PowerShell con sus credenciales, ejecute el siguiente comando.

Connect-MSCommerce

Este comando conecta la sesión actual de PowerShell a un inquilino de Microsoft Entra. El símbolo del sistema le pide un nombre de usuario y una contraseña para el inquilino al que desea conectarse. Si la autenticación multifactor está habilitada para sus credenciales, use la opción interactiva para iniciar sesión.

Ver detalles de AllowSelfServicePurchase

Para ver una descripción del valor del parámetro AllowSelfServicePurchase y el estado predeterminado, en función de la organización, ejecute el siguiente comando:

Get-MSCommercePolicy -PolicyId AllowSelfServicePurchase

Uso de AllowSelfServicePurchase con productos de Microsoft

Esta sección contiene información sobre cómo ver una lista de productos de Microsoft para la compra de autoservicio, su estado actual y cómo establecer el estado. Para obtener información sobre los tipos de oferta de terceros, vea Usar AllowSelfServicePurchase con tipos de oferta de terceros.

Ver una lista de productos de Microsoft de compra de autoservicio y su estado

Para ver una lista de los productos de Microsoft de compra de autoservicio disponibles y el estado de cada uno, ejecute el siguiente comando:

Get-MSCommerceProductPolicies -PolicyId AllowSelfServicePurchase

En la tabla siguiente se enumeran los productos disponibles y su ProductId. También indica qué productos tienen una prueba disponible y no requieren un método de pago. Si procede, todas las demás pruebas requieren un método de pago. En el caso de los productos que tienen la versión de prueba sin el método de pago habilitado, puede habilitar la prueba, manteniendo la capacidad de comprar el producto deshabilitado. Para ver comandos de ejemplo, vea Ver o establecer el estado de AllowSelfServicePurchase para productos de Microsoft.

*Estos elementos son identificadores actualizados. Si anteriormente bloqueó productos con los identificadores antiguos, se bloquearán automáticamente mediante los nuevos identificadores. No se requiere ningún otro trabajo.

Ver o establecer el estado de AllowSelfServicePurchase para productos de Microsoft

Puede establecer el parámetro Value para AllowSelfServicePurchase para permitir o impedir que los usuarios realicen una compra de autoservicio de un producto de Microsoft. También puede usar el valor OnlyTrialsWithoutPaymentMethod para permitir a los usuarios probar productos que no tienen pruebas de pago necesarias. Para ver qué productos tienen habilitadas estas pruebas, consulte la lista de productos en Ver una lista de productos de Microsoft de compra de autoservicio y su estado. Los usuarios solo pueden comprar el producto una vez finalizada la prueba si AllowSelfServicePurchase está habilitado.

En la tabla siguiente se describen los valores del parámetro Value .

Use los siguientes comandos para obtener o establecer la configuración de directiva, donde <ProductID> es la cadena asociada con el nombre del producto.

Para obtener la configuración de directiva para un producto específico, ejecute el siguiente comando:

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

Para habilitar la configuración de directiva para un producto específico, ejecute el siguiente comando:

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

Para deshabilitar la configuración de directiva para un producto específico, ejecute el siguiente comando:

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

Para permitir que los usuarios prueben un producto específico sin un método de pago, ejecute el siguiente comando:

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

Uso de AllowSelfServicePurchase con tipos de oferta de terceros

Esta sección contiene información sobre cómo ver una lista de compra de autoservicio para tipos de oferta de terceros y su estado, y cómo establecer el estado.

Ver una lista de tipos de oferta de compra de autoservicio de terceros y su estado

Para ver una lista de todos los tipos de oferta de terceros de compra de autoservicio disponibles y el estado de cada uno, ejecute el siguiente comando:

Get-MSCommerceProductPolicies -PolicyId AllowSelfServicePurchase -Scope OfferType

En la tabla siguiente se enumeran los tipos de oferta de terceros disponibles. Estos tipos de oferta se pueden habilitar o deshabilitar para la compra de autoservicio.

Ver o establecer el estado de AllowSelfServicePurchase para tipos de oferta de terceros

Puede establecer el parámetro Value para AllowSelfServicePurchase para permitir o impedir que los usuarios realicen una compra de autoservicio de un tipo de oferta de terceros.

En la tabla siguiente se describen los valores del parámetro Value .

Use los siguientes comandos para obtener o establecer la configuración de directiva, donde <ID> es la cadena asociada al tipo de oferta.

Para obtener la configuración de directiva para un tipo de oferta de terceros específico, ejecute el siguiente comando:

Get-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -OfferType <ID>

Para habilitar la configuración de directiva para un tipo de oferta de terceros específico, ejecute el siguiente comando:

Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -OfferType <ID> -Value "Enabled"

Para deshabilitar la configuración de directiva para un tipo de oferta de terceros específico, ejecute el siguiente comando:

Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -OfferType <ID> -Value "Disabled"

Script de ejemplo para deshabilitar AllowSelfServicePurchase

En el ejemplo siguiente se explica cómo importar el módulo MSCommerce , iniciar sesión con su cuenta, obtener productid para Power Automate por usuario y, a continuación, deshabilitar AllowSelfServicePurchase para ese producto.

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"

Si hay varios valores para el producto, puede ejecutar el comando individualmente para cada valor, como se muestra en el ejemplo siguiente:

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

Solución de problemas de HandleError: no se pudo recuperar la directiva con PolicyId "AllowSelfServicePurchase"

En algunos casos, es posible que vea el siguiente mensaje de error:

HandleError: no se pudo recuperar la directiva con PolicyId "AllowSelfServicePurchase", ErrorMessage: se cerró la conexión subyacente: se produjo un error inesperado en un envío.

Este error podría deberse a una versión anterior de Seguridad de la capa de transporte (TLS). Al conectarse a este servicio, debe usar TLS 1.2 o posterior.

Para resolver este error, actualice a TLS 1.2. La sintaxis siguiente actualiza el protocolo de seguridad ServicePointManager para permitir TLS1.2:

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

Para más información, consulte Cómo habilitar TLS 1.2.

Contenido relacionado

Administración de compras de autoservicio (Administración) (artículo)
Preguntas más frecuentes sobre compras de autoservicio (artículo)