MSCommerce.ps1
|
# This file contains functions for MS Commerce # List self-service-purchase products # Aug 27th 2021 function Get-SelfServicePurchaseProducts { <# .SYNOPSIS Lists the status of self-service purchase products .DESCRIPTION Lists the status of self-service purchase products .Parameter AccessToken The access token used to get the status of the self-service purchase products. .Example PS C:\>Get-AADIntAccessTokenForMSCommerce -SaveToCache PS C:\>Get-AADIntSelfServicePurchaseProducts Product Id Status ------- -- ------ Windows 365 Enterprise CFQ7TTC0HHS9 Enabled Windows 365 Business with Windows Hybrid Benefit CFQ7TTC0HX99 Enabled Windows 365 Business CFQ7TTC0J203 Enabled Power Automate per user CFQ7TTC0KP0N Enabled Power Apps per user CFQ7TTC0KP0P Enabled Power Automate RPA CFQ7TTC0KXG6 Enabled Power BI Premium (standalone) CFQ7TTC0KXG7 Enabled Visio Plan 2 CFQ7TTC0KXN8 Enabled Visio Plan 1 CFQ7TTC0KXN9 Enabled Project Plan 3 CFQ7TTC0KXNC Enabled Project Plan 1 CFQ7TTC0KXND Enabled Power BI Pro CFQ7TTC0L3PB Enabled #> [cmdletbinding()] Param( [Parameter(Mandatory=$False)] [String]$AccessToken ) Process { # Get from cache if not provided $AccessToken = Get-AccessTokenFromCache -AccessToken $AccessToken -Resource "aeb86249-8ea3-49e2-900b-54cc8e308f85" -ClientId "3d5cffa9-04da-4657-8cab-c7f074657cad" # Set the headers $headers=@{ "Authorization" = "Bearer $AccessToken" } # Invoke the command $response = Invoke-RestMethod -UseBasicParsing -Method Get -Uri "https://licensing.m365.microsoft.com/v1.0/policies/AllowSelfServicePurchase/products" -Headers $headers # Return the products foreach($item in $response.items) { New-Object psobject -Property ([ordered]@{ "Product" = $item.productName "Id" = $item.productID "Status" = $item.policyValue }) } } } # Change the status of self-service-purchase products # Aug 27th 2021 function Set-SelfServicePurchaseProduct { <# .SYNOPSIS Change the status of the given self-service purchase product .DESCRIPTION Change the status of the given self-service purchase product .Parameter AccessToken The access token used to change the status of the self-service purchase product. .Example PS C:\>Get-AADIntAccessTokenForMSCommerce -SaveToCache PS C:\>Set-AADIntSelfServicePurchaseProduct -Id CFQ7TTC0L3PB -Enabled $false Product Id Status ------- -- ------ Power BI Pro CFQ7TTC0L3PB Disabled .Example Get-AADIntSelfServicePurchaseProducts | Set-AADIntSelfServicePurchaseProduct -Enabled $false Product Id Status ------- -- ------ Windows 365 Enterprise CFQ7TTC0HHS9 Disabled Windows 365 Business with Windows Hybrid Benefit CFQ7TTC0HX99 Disabled Windows 365 Business CFQ7TTC0J203 Disabled Power Automate per user CFQ7TTC0KP0N Disabled Power Apps per user CFQ7TTC0KP0P Disabled Power Automate RPA CFQ7TTC0KXG6 Disabled Power BI Premium (standalone) CFQ7TTC0KXG7 Disabled Visio Plan 2 CFQ7TTC0KXN8 Disabled Visio Plan 1 CFQ7TTC0KXN9 Disabled Project Plan 3 CFQ7TTC0KXNC Disabled Project Plan 1 CFQ7TTC0KXND Disabled Power BI Pro CFQ7TTC0L3PB Disabled #> [cmdletbinding()] Param( [Parameter(Mandatory=$False)] [String]$AccessToken, [Parameter(Mandatory=$True,ValueFromPipelineByPropertyName=$True)] [String]$Id, [Parameter(Mandatory=$True)] [Boolean]$Enabled ) Process { # Get from cache if not provided $AccessToken = Get-AccessTokenFromCache -AccessToken $AccessToken -Resource "aeb86249-8ea3-49e2-900b-54cc8e308f85" -ClientId "3d5cffa9-04da-4657-8cab-c7f074657cad" # Set the headers $headers=@{ "Authorization" = "Bearer $AccessToken" } if($Enabled) { $policyValue = "Enabled" } else { $policyValue = "Disabled" } $body = @{ "policyValue" = $policyValue} # Invoke the command try { $response = Invoke-RestMethod -UseBasicParsing -Method Put -Uri "https://licensing.m365.microsoft.com/v1.0/policies/AllowSelfServicePurchase/products/$Id" -Headers $headers -Body ($body | ConvertTo-Json) -ContentType "application/json; charset=utf-8" # Return New-Object psobject -Property ([ordered]@{ "Product" = $response.productName "Id" = $response.productID "Status" = $response.policyValue }) } catch { throw $_ } } } |