針對 MSCommerce PowerShell 模組使用 AllowSelfServicePurchase

MSCommerce PowerShell 模組現在可在PowerShell 資源庫上 使用。 模組包含 AllowSelfServicePurchasePolicyID 參數值,可讓您控制組織中的使用者是否可以進行自助式購買。

您可以使用 MSCommerce PowerShell 模組來:

  • 檢視 AllowSelfServicePurchase 參數值的預設狀態 — 無論是啟用或停用
  • 檢視適用產品清單,以及是否已啟用或停用自助式購買
  • 檢視或修改特定產品的目前設定,以啟用或停用它

需求

若要使用 MSCommerce PowerShell 模組,您需要:

  • Windows 10裝置
  • PowerShell 5 或以下版本。 此課程模組目前不支援 PowerShell 6.x/7.x。
  • 裝置的系統管理員許可權
  • 租使用者的全域或計費管理員角色

安裝 MSCommerce PowerShell 模組

您會在Windows 10裝置上安裝 MSCommerce PowerShell 模組一次,然後將它匯入您啟動的每個 PowerShell 會話。 從 PowerShell 資源庫 下載 MSCommerce PowerShell 模組。

若要使用 PowerShellGet 安裝 MSCommerce PowerShell 模組,請執行下列命令:

Install-Module -Name MSCommerce

將 MSCommerce 匯入 PowerShell 會話

在Windows 10裝置上安裝模組之後,您會將它匯入到您啟動的每個 PowerShell 會話。 若要將它匯入 PowerShell 會話,請執行下列命令:

Import-Module -Name MSCommerce

使用您的認證連線到 MSCommerce

若要使用您的認證連線到 PowerShell 模組,請執行下列命令。

Connect-MSCommerce

此命令會將目前的 PowerShell 會話連線至 Azure Active Directory 租使用者。 命令會提示您輸入要連線之租使用者的使用者名稱和密碼。 如果您的認證已啟用多重要素驗證,您可以使用互動式選項來登入。

檢視 AllowSelfServicePurchase 的詳細資料

若要檢視 AllowSelfServicePurchase 參數值和預設狀態的描述,請根據您的組織執行下列命令:

Get-MSCommercePolicy -PolicyId AllowSelfServicePurchase

檢視自助式購買產品及其狀態的清單

若要檢視所有可用自助式購買產品的清單和每個產品的狀態,請執行下列命令:

Get-MSCommerceProductPolicies -PolicyId AllowSelfServicePurchase

下表列出可用的產品及其 ProductId

產品 ProductId
每位使用者的 Power Apps* CFQ7TTC0LH2H
每位使用者的 Power Automate CFQ7TTC0KP0N
Power Automate RPA CFQ7TTC0KXG6
Power BI Premium (獨立) CFQ7TTC0KXG7
Power BI Pro CFQ7TTC0L3PB
Project 方案 1* CFQ7TTC0HDB1
Project 方案 3* CFQ7TTC0HDB0
Visio 方案 1* CFQ7TTC0HD33
Visio 方案 2* CFQ7TTC0HD32
Windows 365 企業版 CFQ7TTC0HHS9
Windows 365 商務版 CFQ7TTC0J203
Windows 365 商務版與Windows Hybrid Benefit CFQ7TTC0HX99
Microsoft 365 F3 CFQ7TTC0LH05
Dynamics 365 Marketing CFQ7TTC0LH3N
Dynamics 365 行銷附加 CFQ7TTC0LHWP
Dynamics 365 Marketing 其他應用程式 CFQ7TTC0LHVK
Dynamics 365 Marketing 其他非 Prod 應用程式 CFQ7TTC0LHWM

*這些識別碼已變更。 如果您先前使用舊識別碼封鎖產品,則會使用新的識別碼自動封鎖產品。 不需要額外的工作。

檢視或設定 AllowSelfServicePurchase 的狀態

檢視可供自助式購買的產品清單之後,您可以檢視或修改特定產品的設定。

若要取得特定產品的原則設定,請執行下列命令:

Get-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId CFQ7TTC0KP0N

若要啟用特定產品的原則設定,請執行下列命令:

Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId CFQ7TTC0KP0N -Enabled $True

若要停用特定產品的原則設定,請執行下列命令:

Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId CFQ7TTC0KP0N -Enabled $False

停用 AllowSelfServicePurchase 的範例腳本

下列範例會逐步引導您匯入 MSCommerce 模組、使用您的帳戶登入、取得每位使用者的 Power Automate ProductId ,然後停用該產品的 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 -Enabled $false

如果產品有多個值,您可以針對每個值個別執行 命令,如下列範例所示:

Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId $product[0].ProductID -Enabled $false
Update-MSCommerceProductPolicy -PolicyId AllowSelfServicePurchase -ProductId $product[1].ProductID -Enabled $false

疑難排解

問題

您會看到下列錯誤訊息:

HandleError:無法擷取 PolicyId 為 'AllowSelfServicePurchase'、ErrorMessage 的原則 - 基礎連線已關閉:傳送時發生非預期的錯誤。

這可能是因為舊版的傳輸層安全性 (TLS) 。 若要連線此服務,您需要使用 TLS 1.2 或更新版本

解決方案

升級至 TLS 1.2。 下列語法會將 ServicePointManager 安全性通訊協定更新為 TLS1.2:

 [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::Tls12

若要深入瞭解,請 參閱如何啟用 TLS 1.2

管理自助式購買 (管理員) (文章)

自助式購買常見問題 (文章)