Uso de AllowSelfServicePurchase para el módulo de PowerShell MSCommerce

El módulo de PowerShell MSCommerce ya está disponible en 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.

Puede usar el módulo de PowerShell MSCommerce para:

• Ver el estado predeterminado del valor del parámetro AllowSelfServicePurchase , tanto si está habilitado, deshabilitado o si permite pruebas sin un método de pago
• Ver una lista de productos aplicables y si la compra de autoservicio está habilitada, deshabilitada o permite pruebas sin un método de pago
• Ver o modificar la configuración actual de un producto específico para habilitarlo o deshabilitarlo
• Visualización o modificación de 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.
• PowerShell 5 o posterior. Actualmente, PowerShell 6.x/7.x no es compatible con este módulo.
• El rol administrador global o de facturación del inquilino para cambiar las directivas de producto de MSCommerce .
• Rol lector global para que el inquilino vea una lista de solo lectura de directivas de producto de MSCommerce .

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

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

Para ver una lista de todos los productos 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.

Producto	Productid	¿Está habilitada la prueba sin método de pago?
Clipchamp Premium	CFQ7TTC0N8SS	No
Power Apps por usuario*	CFQ7TTC0LH2H	No
Power Automate por usuario*	CFQ7TTC0LH3L	No
RPA de Power Automate*	CFQ7TTC0LSGZ	No
Power BI Premium (independiente)*	CFQ7TTC0H6RP	No
Power BI Pro*	CFQ7TTC0H9MP	No
Project Plan 1*	CFQ7TTC0HDB1	Sí
Project Plan 3*	CFQ7TTC0HDB0	No
Teams Exploratory	CFQ7TTC0J1FV	Sí
Precios de introducción de Teams Premium	CFQ7TTC0RM8K	Sí
Visio Plan 1*	CFQ7TTC0HD33	Sí
Visio Plan 2*	CFQ7TTC0HD32	No
Viva Goals (solo pruebas de autoservicio)	CFQ7TTC0PW0V	Sí
Windows 365 Enterprise	CFQ7TTC0HHS9	No
Windows 365 Business	CFQ7TTC0J203	No
Windows 365 Business con Ventaja híbrida de Windows	CFQ7TTC0HX99	No
Microsoft 365 F3	CFQ7TTC0LH05	No
Detección de Microsoft Purview	CFQ7TTC0N8SL	Sí

*Estos identificadores han cambiado. 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 una lista de "tipos de oferta de terceros" de compra de autoservicio 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.

Tipo de oferta	Id
Software como servicio	SaaS
Objetos visuales de Power BI	POWERBIVISUALS
Dynamics 365 Dataverse Apps	DYNAMICSCE
Dynamics 365 Business Central	DYNAMICSBC

Ver o establecer el estado de AllowSelfServicePurchase

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

Nota:

Cambiar el valor de AllowSelfServicePurchase o OnlyTrialsWithoutPaymentMethod solo afecta a las pruebas o compras realizadas para el producto especificado a partir de ese momento. Las pruebas o compras existentes para el producto especificado no se ven afectadas.

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

Valor	Impacto
Habilitado	Los usuarios pueden realizar compras de autoservicio y adquirir pruebas para el producto.
OnlyTrialsWithoutPaymentMethod	Los usuarios no pueden realizar compras de autoservicio, pero pueden adquirir pruebas gratuitas para productos que no requieren que agreguen un método de pago. Una vez expirada la prueba, un usuario no puede comprar la versión de pago del producto.
Deshabilitada	Los usuarios no pueden realizar compras de autoservicio ni adquirir pruebas para el producto.

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

Get-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId CFQ7TTC0KP0N

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

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

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

Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId CFQ7TTC0KP0N -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 CFQ7TTC0KP0N -Value "OnlyTrialsWithoutPaymentMethod" 

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:

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"

Solución de problemas

Problema

Verá 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.

Esto puede 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

Solución

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)