Module PowerShell du Microsoft Store pour Entreprises et Éducation - Version d'essai

  • Article

S’applique à :

  • Windows 10

Important

Le module PowerShell du Microsoft Store pour Entreprises et Éducation (version d'essai) est désormais disponible sur PowerShell Gallery.

Remarque

Il s'agit d'une version d'essai qui n'est pas destinée à des environnements de production. Pour les environnements de production, continuez à utiliser le Microsoft Store pour Entreprise et Éducation ou votre outil GPM pour gérer les licences. Les exemples de scripts ne sont pris en charge sous aucun programme ou service de support standard de Microsoft. Les exemples de script sont fournis EN L'ÉTAT sans aucune garantie. Microsoft décline toute garantie, y compris et de manière non exclusive toute garantie de qualité marchande ou de correspondance à des fins particulières. Vous assumez l’ensemble des risques relatifs à l’utilisation ou aux performances des exemples de scripts et de la documentation. En aucun cas sont Microsoft, ses auteurs ou toute autre entité impliquée dans la création, la production ou la distribution des scripts ne seront tenus responsables de tout dommage que ce soit (y compris et de manière non exclusive les pertes de bénéfices, l'interruption d’activité, la perte d’informations commerciales ou autres pertes pécuniaires) relatif à l’utilisation ou à l’impossibilité d’utiliser les exemples de scripts ou la documentation, même si Microsoft a été prévenu de l’éventualité de tels dommages.

Vous pouvez utiliser le module PowerShell pour :

  • Affichage des éléments que vous avez achetés - affichés dans Produits et services
  • Gérer les licences - affectation et suppression
  • Effectuez des opérations en bloc avec des fichiers .csv - automatise la gestion des licences pour les clients avec un plus grand nombre de licences

Remarque

L'affectation des applications à des groupes n’est pas prise en charge via ce module. Au lieu de cela, nous vous recommandons de tirer parti des modules PowerShell Microsoft Entra ID ou Microsoft Graph pour enregistrer les membres d’un groupe dans un fichier CSV et de suivre les instructions ci-dessous sur l’utilisation du fichier CSV pour gérer les affectations.

Conditions requises

Pour utiliser le module PowerShell du Microsoft Store pour Entreprises et Éducation, vous aurez besoin des éléments suivants :

  • Autorisation d’administrateur pour l'appareil
  • Le rôle d'administrateur pour le Microsoft Store pour Entreprise et Éducation

Mise en route du module PowerShell du Microsoft Store pour Entreprises et Éducation

Toutes les applets de commande PowerShell du Microsoft Store pour Entreprise et Éducation suivent le modèle Verbe- MSStoreSubstantif pour indiquer clairement qu’ils fonctionnent avec le module PowerShell du Microsoft Store pour Entreprise et Éducation. Vous devez installer le module sur votre appareil Windows 10 une fois et puis l’importer dans chaque session PowerShell que vous lancez.

Installer le module PowerShell du Microsoft Store pour Entreprises et Éducation

Remarque

L’installation du module PowerShell du Microsoft Store pour Entreprises et Éducation à l'aide de PowerShellGet requiert Windows Management Framework 5.0. Par défaut, l’infrastructure est incluse dans Windows 10).

Pour installer PowerShell Microsoft Store pour Entreprises et Éducation avec PowerShellGet, exécutez la commande suivante :

# Install the Microsoft Store for Business and Education PowerShell module from PowerShell Gallery

Install-Module -Name MSStore

Importer le module PowerShell du Microsoft Store pour Entreprises et Éducation dans la session PowerShell

Après avoir installé le module sur votre appareil Windows 10, vous devrez l’importer dans chaque session PowerShell que vous lancez.

# Import the MSStore module into this session

Import-Module -Name MSStore

Ensuite, autorisez le module à invoquer Microsoft Store pour Entreprises et Éducation à votre place. Cette étape est requise une fois pour chaque utilisateur du module PowerShell.

Pour autoriser le module PowerShell, exécutez cette commande. Vous devrez vous connecter à votre compte professionnel ou scolaire et autoriser le module à accéder à votre titulaire.

# Grant MSStore Access to your Microsoft Store for Business and Education

Grant-MSStoreClientAppAccess

Vous serez invité à vous connecter avec votre compte professionnel ou scolaire, puis à autoriser le module PowerShell à accéder à votre compte Microsoft Store pour Entreprises et Éducation. Une fois que le module a été importé dans la session PowerShell actuelle et autorisé à appeler votre compte Microsoft Store pour Entreprises et Éducation, les applets de commande Microsoft Graph PowerShell sont chargées et prêtes à être utilisées.

Afficher les éléments dans Produits et services

La gestion des services ne devez rencontrer aucune modification important suite à la séparation de la gestion Azure Service et de la version d'essai PowerShell Microsoft Store pour Entreprise et Éducation.

# View items in inventory (Apps & software)

Get-MSStoreInventory

Astuce

Get-MSStoreInventory ne retourne pas le nom du produit pour les applications métier. Pour obtenir l’ID produit et la référence (SKU) pour une application métier :

  1. Connectez-vous au portail Microsoft Store pour Entreprises ou Microsoft Store pour Éducation.
  2. Cliquez sur Gérer, puis choisissez Applications et logiciels.
  3. Cliquez sur l'applications métier. L’URL de la page contient l’ID produit et la référence (SKU) dans le cadre de l’URL. Par exemple : URL après les applications/ est l’ID de produit et la référence SKU suivante.

Afficher les personnes affectées à un produit

La plupart des éléments sous Produits et services dans le Microsoft Store pour Entreprises et Éducation doivent être attribués à des individus appartenant à votre organisation. Vous pouvez afficher les personnes attribuées à un produit spécifique à l’aide des commandes suivantes :

# View products assigned to people

Get-MSStoreSeatAssignments -ProductId 9NBLGGH4R2R6 -SkuId 0016

Important

Le Microsoft Store pour Entreprises et Éducation identifie les types de licence Minecraft : Education Edition à l’aide d’une combinaison de l’ID produit et l’ID de référence (SKU). Pour gérer les attributions de licence pour votre Minecraft : Education Edition, vous devez spécifier l'ID produit et l’ID de référence (SKU) pour les licences que vous souhaitez gérer dans l’applet de commande. Le tableau suivant répertorie l'ID produit et l'ID de référence (SKU).

Type de licence ID produit ID de référence (SKU)
Acheté via le Microsoft Store pour Entreprises et Éducation à l'aide d'une carte de crédit CFQ7TTC0K5DR 0001
Acheté via le Microsoft Store pour Entreprises et Éducation avec d'une facture CFQ7TTC0K5DR 0004
Acheté via l'accord de licence de volume Microsoft CFQ7TTC0K5DR 0002
Acquis via une promotion d'appareil Windows 10 CFQ7TTC0K5DR 0005

Attribuer ou récupérer des produits

Après avoir énumérés les éléments dans Produits et services, vous pouvez affecter ou récupérer les licences vers et depuis les membres dans votre organisation.

Ces commandes affectent un produit à un utilisateur, puis de le récupèrent.

# 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'

Attribuer ou récupérer un produit avec un fichier .csv

Vous pouvez également utiliser le module PowerShell pour effectuer des opérations en bloc sur des éléments de Produits et Services. Vous aurez besoin d’un fichier .CSV avec au moins une colonne pour « Noms de principal » (par exemple, user@host.com). Vous pouvez créer un fichier CSV à l’aide du module PowerShell AzureAD.

Pour attribuer ou récupérer les sièges en bloc :

# 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

Désinstaller le module PowerShell du Microsoft Store pour Entreprises et Éducation

Vous pouvez supprimer PowerShell Microsoft Store pour Entreprises et Éducation à partir de votre ordinateur en exécutant la commande PowerShell suivante.

# Uninstall the MSStore Module

Get-InstalledModule -Name "MSStore" -RequiredVersion 1.0 | Uninstall-Module