From a4ee56867d10d7431d2684e3848abd63c2fa4a2e Mon Sep 17 00:00:00 2001 From: Jeanie Decker Date: Wed, 2 Aug 2017 17:52:53 +0000 Subject: [PATCH] Merged PR 2519: Add topic for PowerShell module --- store-for-business/TOC.md | 1 + ...y-management-windows-store-for-business.md | 16 +- store-for-business/images/lob-sku.png | Bin 0 -> 14086 bytes ...or-business-education-powershell-module.md | 155 ++++++++++++++++++ store-for-business/sfb-change-history.md | 7 + 5 files changed, 178 insertions(+), 1 deletion(-) create mode 100644 store-for-business/images/lob-sku.png create mode 100644 store-for-business/microsoft-store-for-business-education-powershell-module.md diff --git a/store-for-business/TOC.md b/store-for-business/TOC.md index 955e447800..0b9807c98b 100644 --- a/store-for-business/TOC.md +++ b/store-for-business/TOC.md @@ -21,6 +21,7 @@ ### [Manage private store settings](manage-private-store-settings.md) ### [Configure MDM provider](configure-mdm-provider-windows-store-for-business.md) ### [Manage Windows device deployment with Windows AutoPilot Deployment](add-profile-to-devices.md) +### [Microsoft Store for Business and Education PowerShell module - preview](microsoft-store-for-business-education-powershell-module.md) ## [Device Guard signing portal](device-guard-signing-portal.md) ### [Add unsigned app to code integrity policy](add-unsigned-app-to-code-integrity-policy.md) ### [Sign code integrity policy with Device Guard signing](sign-code-integrity-policy-with-device-guard-signing.md) diff --git a/store-for-business/app-inventory-management-windows-store-for-business.md b/store-for-business/app-inventory-management-windows-store-for-business.md index 379618509a..062c2dbeef 100644 --- a/store-for-business/app-inventory-management-windows-store-for-business.md +++ b/store-for-business/app-inventory-management-windows-store-for-business.md @@ -7,6 +7,8 @@ ms.mktglfcycl: manage ms.sitesec: library ms.pagetype: store author: TrudyHa +ms.author: TrudyHa +ms.date: 06/29/2017 --- # App inventory management for Microsoft Store for Business and Education @@ -165,4 +167,16 @@ You can download offline-licensed apps from your inventory. You'll need to downl For more information about online and offline licenses, see [Apps in the Microsoft Store for Business](apps-in-windows-store-for-business.md#licensing-model). -For more information about downloading offline-licensed apps, see [Download offline apps](distribute-offline-apps.md). \ No newline at end of file +For more information about downloading offline-licensed apps, see [Download offline apps](distribute-offline-apps.md). + +## Manage products programmatically + +Microsoft Store for Business and Education provides a set of Admin management APIs. If you orgranization develops scripts or tools, these APIs allow Admins to programmatically manage items in **Apps & software**. For more information, see [REST API reference for Microsoft Store for Business](https://docs.microsoft.com/windows/client-management/mdm/rest-api-reference-windows-store-for-business). + +You can download a preview PoweShell script that uses REST APIs. The script is available from PowerShell Gallery. You can use to the script to: +- View items in inventory (**Apps & software**) +- Manage licenses - assigning and removing +- Perform bulk options using .csv files - this automates license management for customers with large numbers of licenses + +> [!NOTE] +> The Microsoft Store for Business and Education Admin role is required to manage products and to use the MSStore module. This requires advanced knowledge of PowerShell. \ No newline at end of file diff --git a/store-for-business/images/lob-sku.png b/store-for-business/images/lob-sku.png new file mode 100644 index 0000000000000000000000000000000000000000..8637fd3f3dbafab3806a8c6d875912bfd5d8c40d GIT binary patch literal 14086 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

2ff~?=SCRG= z2GX4<@sS_^)KIe{>XP>wmN{Ye-=sFGn*^~CbCwoh(i(C!9+RWZ{!IwWFsbLq3hQZ)g2y z%}CwZe{9meJ%l|_ClMr6 W9tX-FBmZ{|pd|O^RXNx!=zjo059F%= literal 0 HcmV?d00001 diff --git a/store-for-business/microsoft-store-for-business-education-powershell-module.md b/store-for-business/microsoft-store-for-business-education-powershell-module.md new file mode 100644 index 0000000000..b36cf701fa --- /dev/null +++ b/store-for-business/microsoft-store-for-business-education-powershell-module.md @@ -0,0 +1,155 @@ +--- +title: Microsoft Store for Business and Education PowerShell module - preview +description: Preview version of PowerShell module +ms.prod: w10 +ms.mktglfcycl: manage +ms.sitesec: library +ms.pagetype: store +author: TrudyHa +localizationpriority: high +ms.author: +ms.date: +--- + +# Microsoft Store for Business and Education PowerShell module - preview + +**Applies to** +- Windows 10 + +Microsoft Store for Business and Education PowerShell module (preview) is now available on [PowerShell Gallery](https://go.microsoft.com/fwlink/?linkid=853459). + +> [!NOTE] +> This is a preview and not intended for production environments. For production environments, continue to use **Microsoft Store for Business and Education** or your MDM tool to manage licenses. The sample scripts are not supported under any Microsoft standard support program or service. The sample scripts are provided AS IS without warranty of any kind. Microsoft further disclaims all implied warranties including, without limitation, any implied warranties of merchantability or of fitness for a particular purpose. The entire risk arising out of the use or performance of the sample scripts and documentation remains with you. In no event shall Microsoft, its authors, or anyone else involved in the creation, production, or delivery of the scripts be liable for any damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information, or other pecuniary loss) arising out of the use of or inability to use the sample scripts or documentation, even if Microsoft has been advised of the possibility of such damages. + +You can use the PowerShell module to: +- View items you've purchased - shown in **Apps & software** +- Manage licenses - assigning and removing +- Perform bulk operations with .csv files - automates license management for customers with larger numbers of licenses + +>[!NOTE] +>Assigning apps to groups is not supported via this module. Instead, we recommend leveraging the Azure Active Directory Or MSOnline Modules to save members of a group to a CSV file and follow instructions below on how to use CSV file to manage assignments. + +## Requirements +To use the Microsoft Store for Business and Education PowerShell module, you'll need: +- Administrator permission for the device +- Admin role for Microsoft Store for Business and Education + + +## Get started with Microsoft Store for Business and Education PowerShell module +All of the **Microsoft Store for Business and Education** PowerShell cmdlets follow the *Verb*-MSStore*Noun* pattern to clearly indicate that they work with **Microsoft Store for Business and Education** PowerShell module. You will need to install the module on your Windows 10 device once and then import it into each PowerShell session you start. + +## Install Microsoft Store for Business and Education PowerShell module +> [!NOTE] +> Installing **Microsoft Store for Business and Education** PowerShell model using **PowerShellGet** requires [Windows Management Framework 5.0](http://www.microsoft.com/download/details.aspx?id=48729). The framework is included with Windows 10 by default). + +To install **Microsoft Store for Business and Education PowerShell** with PowerShellGet, run this command: + +```powershell +# Install the Microsoft Store for Business and Education PowerShell module from PowerShell Gallery + +Install-Module -Name MSStore + +``` + +## Import MIcrosoft Store for Business and Education PowerShell module into the PowerShell session +Once you install the module on your Windows 10 device, you will need to then import it into each PowerShell session you start. + +```powershell +# Import the MSStore module into this session + +Import-Module -Name MSStore + +``` + +Next, authorize the module to call **Microsoft Store for Business and Education** on your behalf. This step is required once, per user of the PowerShell module. + +To authorize the PowerShell module, run this command. You'll need to sign-in with your work or school account, and authorize the module to access your tenant. + +```powershell +# Grant MSStore Access to your Microsoft Store for Business and Education + +Grant-MSStoreClientAppAccess + +``` +You will be promted to sign in with your work or school account and then to authorize the PowerShell Module to access your **Microsoft Store for Business and Education** account. Once the module has been imported into the current PowerShell session and authorized to call into your **Microsoft Store for Business and Education** account, Azure PowerShell cmdlets are loaded and ready to be used. + +## View items in Products and Services +Service management should encounter no breaking changes as a result of the separation of Azure Service Management and **Microsoft Store for Business and Education PowerShell** preview. + +```powershell +# View items in inventory (Apps & software) + +Get-MSStoreInventory + +``` + +>[!TIP] +>**Get-MSStoreInventory** won't return the product name for line-of-business apps. To get the product ID and SKU for a line-of-business app: +> +>1. Sign in to [Microsoft Store for Business](https://go.microsoft.com/fwlink/p/?LinkId=691845) or [Microsoft Store for Education](https://businessstore.microsoft.com/). +>2. Click **Manage** and then choose **Apps & software**. +>3. Click the line-of-business app. The URL of the page will contain the product ID and SKU as part of the URL. For example: +>![Url after apps/ is product id and next is SKU](images/lob-sku.png) + +## View people assigned to a product +Most items in **Products and Services** in **Microsoft Store for Business and Education** need to be assigned to people in your org. You can view the people in your org assigned to a specific product by using these commands: + +```powershell +# View products assigned to people + +Get-MSStoreSeatAssignments -ProductId 9NBLGGH4R2R6 -SkuId 0016 + +``` + +> [!Important] +> Microsoft Store for Business and Education identifies Minecraft: Education Edition license types using a combination of Product ID and SKU ID. To manage license assignments for your Minecraft: Education Edition, you need to specify Product and SKU IDs for the licenses you want to manage in the cmdlet. The following table lists the Product and SKU IDs. + + +| License Type | Product ID | SKU ID | +| ------------ | -----------| -------| +| Purchased through Microsoft Store for Business and Education with a credit card | CFQ7TTC0K5DR | 0001 | +| Purchased through Microsoft Store for Business and Education with an invoice | CFQ7TTC0K5DR | 0004 | +| Purchased through Microsoft Volume Licensing Agreement | CFQ7TTC0K5DR | 0002 | +| Acquired through Windows 10 device promotion | CFQ7TTC0K5DR | 0005 | + +## Assign or reclaim products +Once you have enumerated items in **Products and Service**, you can assign or reclaim licenses to and from people in your org. + +These commands assign a product to a user and then reclaim it. + +```powershell +# Assign Product (Product ID and SKU ID combination) to a User (user@host.com) + +Add-MSStoreSeatAssignment -ProductId 9NBLGGH4R2R6 -SkuId 0016 -Username 'user@myorganization.onmicrosoft.com' + +# Reclaim a product (Product ID and SKU ID combination) from a User (user@host.com) + +Remove-MSStoreSeatAssignment -ProductId 9NBLGGH4R2R6 -SkuId 0016 -Username 'user@myorganization.onmicrosoft.com' + +``` + +## Assign or reclaim a product with a .csv file +You can also use the PowerShell module to perform bulk operations on items in **Product and Services**. You'll need a .CSV file with at least one column for “Principal Names” (for example, user@host.com). You can create such a CSV using the AzureAD PowerShell Module. + +**To assign or reclaim seats in bulk:** + +```powershell +# Assign Product (Product ID and SKU ID combination) to a User (user@host.com) + +Add-MSStoreSeatAssignments -ProductId 9NBLGGH4R2R6 -SkuId 0016 -PathToCsv C:\People.csv -ColumnName UserPrincipalName + +# Reclaim a product (Product ID and SKU ID combination) from a User (user@host.com) + +Remove-MSStoreSeatAssignments -ProductId 9NBLGGH4R2R6 -SkuId 0016 -PathToCsv C:\People.csv -ColumnName UserPrincipalName + +``` + +## Uninstall Microsoft Store for Business and Education PowerShell module +You can remove **Microsoft Store for Business and Education PowerShell** from your computer by running the following PowerShell Command. + +```powershell +# Uninstall the MSStore Module + +Get-InstalledModule -Name "MSStore" -RequiredVersion 1.0 | Uninstall-Module + +``` \ No newline at end of file diff --git a/store-for-business/sfb-change-history.md b/store-for-business/sfb-change-history.md index 32d008321d..ed0904b3ee 100644 --- a/store-for-business/sfb-change-history.md +++ b/store-for-business/sfb-change-history.md @@ -18,6 +18,13 @@ ms.localizationpriority: high - Windows 10 - Windows 10 Mobile +## July 2017 + +| New or changed topic | Description | +| --- | --- | +| [Microsoft Store for Business and Education PowerShell module - preview](microsoft-store-for-business-education-powershell-module.md) | New | + + ## June 2017 | New or changed topic | Description | | -------------------- | ----------- |