Использование AllowSelfServicePurchase для модуля MSCommerce PowerShell

Модуль MSCommerce PowerShell теперь доступен на коллекция PowerShell. Модуль содержит значение параметра PolicyID для AllowSelfServicePurchase , которое позволяет контролировать, могут ли пользователи в вашей организации самостоятельно приобретать майкрософт или выбирать сторонние предложения.

Модуль MSCommerce PowerShell можно использовать для следующих способов:

  • Просмотр состояния по умолчанию значения параметра AllowSelfServicePurchase — включен, отключен или разрешен пробных версий без метода оплаты.
  • Просмотрите список применимых продуктов и сведения о том, включена ли, отключена или разрешена ли самостоятельная покупка пробных версий без способа оплаты.
  • Просмотр или изменение текущего параметра для определенного продукта, чтобы включить или отключить его
  • Просмотр или изменение параметра для пробных версий без методов оплаты

Требования

Чтобы использовать модуль MSCommerce PowerShell, вам потребуется следующее:

  • Операционная система Windows 10 или более поздней версии.
  • PowerShell 5 или более поздней версии. В настоящее время PowerShell 6.x/7.x не поддерживается в этом модуле.
  • Роль глобального администратора или администратора выставления счетов для клиента, чтобы изменить политики продуктов MSCommerce .
  • Роль глобального читателя для клиента, чтобы просмотреть список политик продуктов MSCommerce только для чтения.

Установка модуля MSCommerce PowerShell

Вы устанавливаете модуль MSCommerce PowerShell на Windows 10 устройстве один раз, а затем импортируете его в каждый сеанс PowerShell, который вы запускаете. Скачайте модуль MSCommerce PowerShell с коллекция PowerShell.

Чтобы установить модуль MSCommerce PowerShell с помощью PowerShellGet, выполните следующую команду:

Install-Module -Name MSCommerce

Импорт MSCommerce в сеанс PowerShell

После установки модуля на Windows 10 устройстве вы импортируете его в каждый сеанс PowerShell, который запускаете. Чтобы импортировать его в сеанс PowerShell, выполните следующую команду:

Import-Module -Name MSCommerce

Подключение к MSCommerce с помощью учетных данных

Чтобы подключиться к модулю PowerShell с учетными данными, выполните следующую команду.

Connect-MSCommerce

Эта команда подключает текущий сеанс PowerShell к клиенту Microsoft Entra. Команда запрашивает имя пользователя и пароль для клиента, к которому вы хотите подключиться. Если для учетных данных включена многофакторная проверка подлинности, используйте интерактивный параметр для входа.

Просмотр сведений о AllowSelfServicePurchase

Чтобы просмотреть описание значения параметра AllowSelfServicePurchase и состояния по умолчанию на основе вашей организации, выполните следующую команду:

Get-MSCommercePolicy -PolicyId AllowSelfServicePurchase

Просмотр списка продуктов для самостоятельной покупки и их состояния

Чтобы просмотреть список всех доступных продуктов для самостоятельной покупки и состояние каждого из них, выполните следующую команду:

Get-MSCommerceProductPolicies -PolicyId AllowSelfServicePurchase

В следующей таблице перечислены доступные продукты и их ProductId. Он также указывает, какие продукты имеют доступную пробную версию и не требуют метода оплаты. Если применимо, для всех остальных пробных версий требуется метод оплаты. Для продуктов с пробной версией без включенного метода оплаты можно включить пробную версию, сохраняя возможность приобретения продукта отключенной. Примеры команд см. в разделе Просмотр или установка состояния allowSelfServicePurchase.

Продукт Productid Включена ли пробная версия без способа оплаты?
Clipchamp Premium CFQ7TTC0N8SS Нет
Power Apps на пользователя* CFQ7TTC0LH2H Нет
Power Automate на пользователя* CFQ7TTC0LH3L Нет
Power Automate RPA* CFQ7TTC0LSGZ Нет
Power BI Premium (автономная)* CFQ7TTC0H6RP Нет
Power BI Pro* CFQ7TTC0H9MP Нет
Project, план 1* CFQ7TTC0HDB1 Да
Project, план 3* CFQ7TTC0HDB0 Нет
Teams Exploratory CFQ7TTC0J1FV Да
Teams премиум ознакомительные цены CFQ7TTC0RM8K Да
Visio, план 1* CFQ7TTC0HD33 Да
Visio, план 2* CFQ7TTC0HD32 Нет
Viva Goals (только для пробных версий самообслуживания) CFQ7TTC0PW0V Да
Windows 365 Корпоративная CFQ7TTC0HHS9 Нет
Windows 365 для бизнеса CFQ7TTC0J203 Нет
Windows 365 для бизнеса с Преимущество гибридного использования Windows CFQ7TTC0HX99 Нет
Microsoft 365 F3 CFQ7TTC0LH05 Нет
Обнаружение Microsoft Purview CFQ7TTC0N8SL Да

*Эти идентификаторы изменились. Если вы ранее блокировали продукты с помощью старых идентификаторов, они автоматически блокируются с помощью новых идентификаторов. Никаких других работ не требуется.

Просмотр списка самостоятельных покупок "сторонних типов предложений" и их состояния

Чтобы просмотреть список всех доступных типов предложений сторонних поставщиков для самостоятельной покупки и состояния каждого из них, выполните следующую команду:

Get-MSCommerceProductPolicies -PolicyId AllowSelfServicePurchase -Scope OfferType

В следующей таблице перечислены доступные типы сторонних предложений. Эти типы предложений можно включить или отключить для самостоятельной покупки.

Тип предложения Id
ПО как услуга SaaS
Визуальные элементы Power BI POWERBIVISUALS
приложения dataverse Dynamics 365 DYNAMICSCE
Dynamics 365 Business Central DYNAMICSBC

Просмотр или установка состояния allowSelfServicePurchase

Вы можете задать параметр Value для AllowSelfServicePurchase , чтобы разрешить или запретить пользователям совершать самостоятельные покупки. Вы также можете использовать значение OnlyTrialsWithoutPaymentMethod , чтобы позволить пользователям попробовать продукты, которые не имеют необходимых для оплаты пробных версий. Ознакомьтесь со списком продуктов выше, чтобы узнать, для каких продуктов включены эти пробные версии. Пользователи могут приобрести продукт только после окончания пробной версии, если включен параметр AllowSelfServicePurchase .

Примечание.

Изменение значения AllowSelfServicePurchase или OnlyTrialsWithoutPaymentMethod влияет только на пробные версии или покупки, сделанные для указанного продукта с этого момента. Существующие пробные версии или покупки для указанного продукта не затрагиваются.

В следующей таблице описаны параметры параметра Value .

Параметр Влияние
Включено Пользователи могут совершать самостоятельные покупки и получать пробные версии для продукта.
OnlyTrialsWithoutPaymentMethod Пользователи не могут совершать самостоятельные покупки, но могут приобрести бесплатные пробные версии для продуктов, которые не требуют добавления метода оплаты. По истечении срока действия пробной версии пользователь не сможет приобрести платную версию продукта.
Отключено Пользователи не могут совершать самостоятельные покупки или приобретать пробные версии для продукта.

Чтобы получить параметр политики для определенного продукта, выполните следующую команду:

Get-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId CFQ7TTC0KP0N

Чтобы включить параметр политики для определенного продукта, выполните следующую команду:

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

Чтобы отключить параметр политики для определенного продукта, выполните следующую команду:

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

Чтобы разрешить пользователям попробовать определенный продукт без метода оплаты, выполните следующую команду:

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

Чтобы получить параметр политики для определенного типа предложения стороннего производителя, выполните следующую команду:

Get-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -OfferType <ID>

Чтобы включить параметр политики для определенного типа предложения стороннего производителя, выполните следующую команду:

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

Чтобы отключить параметр политики для определенного типа предложения стороннего производителя, выполните следующую команду:

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

Пример скрипта для отключения AllowSelfServicePurchase

В следующем примере показано, как импортировать модуль MSCommerce , войти с помощью учетной записи, получить ProductId для Power Automate для каждого пользователя, а затем отключить AllowSelfServicePurchase для этого продукта.

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"

Если для продукта есть несколько значений, можно выполнить команду по отдельности для каждого значения, как показано в следующем примере:

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"

Устранение неполадок

Проблема

Появится следующее сообщение об ошибке:

HandleError : не удалось получить политику с PolicyId AllowSelfServicePurchase, ErrorMessage — базовое подключение было закрыто: произошла непредвиденная ошибка при отправке.

Это может быть связано с более старой версией ПРОТОКОЛА TLS. При подключении к этой службе необходимо использовать TLS 1.2 или более поздней версии.

Решение

Обновление до TLS 1.2. Следующий синтаксис обновляет протокол безопасности ServicePointManager, чтобы разрешить TLS1.2:

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

Дополнительные сведения см. в статье Включение TLS 1.2.

Управление самостоятельными покупками (Администратор) (статья)
Вопросы и ответы о самостоятельной покупке (статья)