針對 MSCommerce PowerShell 模組使用 AllowSelfServicePurchase
MSCommerce PowerShell 模組現在可在PowerShell 資源庫上 使用。 模組包含 AllowSelfServicePurchase 的 PolicyID 參數值,可讓您控制組織中的使用者是否可以進行自助式購買。
您可以使用 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。
相關內容
管理自助式購買 (管理員) (文章)
自助式購買常見問題 (文章)