Use AllowSelfServicePurchase para el módulo MSCommerce de PowerShell

El módulo MSCommerce PowerShell está disponible en la 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, consulta Administrar compras y pruebas de autoservicio (para administradores).

Puede usar el módulo MSCommerce PowerShell para:

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

Requisitos

Para usar el módulo MSCommerce PowerShell, necesita:

• Un sistema operativo de Windows 10 o posterior.
• El rol global o administrador de facturación del inquilino para cambiar las directivas de producto de MSCommerce .

  Precaución

  Los administradores globales tienen acceso casi ilimitado a la configuración de su organización y a la mayoría de sus datos. Para ayudar a proteger su organización, le recomendamos que limite el número de administradores globales tanto como sea posible.

• El rol de lector global para que su espacio empresarial vea una lista de solo lectura de las directivas de producto de MSCommerce .
• Asociados que son administradores en nombre de (AOBO) Un cliente debe tener un rol establecido en Administrador global para administrar y deshabilitar las compras de autoservicio en el Centro de administración de Microsoft 365 y a través de PowerShell.

Introducción al módulo MSCommerce de PowerShell

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

Instale el módulo MSCommerce PowerShell

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

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

Install-Module -Name MSCommerce

Importar MSCommerce en la sesión de PowerShell

Después de instalar el módulo en tu dispositivo con Windows 10, impórtalo en cada sesión de PowerShell que inicies. Para importarlo en una sesión de PowerShell, ejecute el siguiente comando:

Import-Module -Name MSCommerce

Conéctese 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 comando le pedirá un nombre de usuario y una contraseña para el inquilino al que desea conectarse. Si está habilitada la autenticación multifactor 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 su organización, ejecute el siguiente comando:

Get-MSCommercePolicy -PolicyId AllowSelfServicePurchase

Usar 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 compra de autoservicio de productos de Microsoft y su estado

Para ver una lista de los productos de autoservicio de Microsoft 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 versión de 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 método de pago habilitado, puedes habilitar la versión de prueba, a la vez que mantienes deshabilitada la capacidad de comprar el producto. Para obtener comandos de ejemplo, consulte Ver o establecer el estado de AllowSelfServicePurchase para productos de Microsoft.

*Estos elementos son identificadores actualizados. Si has bloqueado previamente productos con los identificadores antiguos, se bloquean automáticamente con 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 de valor de 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 que los usuarios prueben productos que no tengan pruebas que requieran pago. Para ver qué productos tienen habilitadas estas pruebas, consulta la lista de productos en Ver una lista de compra de autoservicio de productos de Microsoft y su estado. Los usuarios solo pueden comprar el producto una vez finalizada la prueba si AllowSelfServicePurchase está habilitado.

En la tabla siguiente se describe la configuración del parámetro Value .

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

Para obtener la configuración de directiva de 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 ofertas de terceros y su estado, y cómo establecer el estado.

Ver una lista de tipos de ofertas de compras de terceros de autoservicio y su estado

Para ver una lista de todos los tipos de ofertas de autoservicio disponibles de terceros 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 ofertas 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 ofertas de terceros

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

En la tabla siguiente se describe la configuración del parámetro Value .

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

Para obtener la configuración de directiva de 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

El siguiente ejemplo le explica cómo importar el módulo MSCommerce , iniciar sesión con su cuenta, obtener el 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"}

Solucionar 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 puede deberse a una versión anterior de Seguridad de la capa de transporte (TLS). Cuando se conecte a este servicio, debe usar TLS 1.2 o superior.

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

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

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

Contenido relacionado

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