Commandes (MSI/EXE)

Installation

Étape 1 : Installer .NET Windows Runtime

Si vous ne l’avez pas déjà fait, installez la dernière version du Runtime de bureau .NET 8. Il s’agit d’une exigence d’exécution de l’interface CLI du développeur du Microsoft Store.

Le moyen le plus simple de l’installer consiste à utiliser winget :

winget install Microsoft.DotNet.DesktopRuntime.8

Étape 2 : Installer l’interface CLI du développeur du Microsoft Store sur Windows

Vous pouvez télécharger l’interface CLI du développeur du Microsoft Store à partir du Microsoft Store. Vous pouvez également utiliser winget :

winget install "Microsoft Store Developer CLI"

Étape 1 : Installer le runtime .NET macOS

Si ce n’est déjà fait, installez la dernière version du runtime .NET 8. Il s’agit d’une exigence d’exécution de l’interface CLI du développeur du Microsoft Store.

Étape 2 : Installer l’interface CLI du développeur du Microsoft Store sur macOS

Vous pouvez télécharger le .tar.gz macOS pour votre architecture spécifique (x64 ou Arm64) à partir de la page des versions de l’interface CLI pour développeurs du Microsoft Store. Une fois téléchargé, extrayez l’archive et placez-la dans votre variable d'environnement PATH selon vos préférences, par exemple:

mkdir MSStoreCLI
curl https://github.com/microsoft/msstore-cli/releases/latest/download/MSStoreCLI-osx-x64.tar.gz -o MSStoreCLI-osx-x64.tar.gz
tar -xvf MSStoreCLI-osx-x64.tar.gz -C ./MSStoreCLI
sudo cp -R MSStoreCLI/. /usr/local/bin

Vous pouvez également utiliser brew :

brew install microsoft/msstore-cli/msstore-cli

Étape 1 : Installer le runtime .NET Linux

Si ce n’est déjà fait, installez la dernière version du runtime .NET 8. Il s’agit d’une exigence d’exécution de l’interface CLI du développeur du Microsoft Store.

Étape 2 : Installer l’interface CLI du développeur du Microsoft Store sur Linux

Vous pouvez télécharger le .tar.gz Linux pour votre architecture spécifique (x64 ou Arm64) à partir de la page des versions de l’interface CLI pour développeurs du Microsoft Store. Une fois téléchargé, extrayez l'archive et placez-la dans votre variable d’environnement PATH, de la manière que vous préférez, par exemple :

mkdir MSStoreCLI
wget https://github.com/microsoft/msstore-cli/releases/latest/download/MSStoreCLI-linux-x64.tar.gz
tar -xvf MSStoreCLI-linux-x64.tar.gz -C ./MSStoreCLI
sudo cp -R MSStoreCLI/. /usr/local/bin

Vous pouvez également utiliser brew :

brew install microsoft/msstore-cli/msstore-cli

Commande Info

Imprimer la configuration existante.

Usage

msstore info

Options

Choix	Descriptif
-v, --détaillé	Imprimer une sortie verbeuse.
-?, -h, --help	Affichez les informations d’aide et d’utilisation.

Reconfigurer la commande

Configurez à nouveau l’interface CLI du développeur du Microsoft Store. Vous pouvez fournir un secret client ou un certificat. Les certificats peuvent être fournis via son empreinte numérique ou en fournissant un chemin d’accès de fichier (avec ou sans mot de passe).

Usage

msstore reconfigure

Options

Choix	Descriptif
-t, --identifiantLocataire	Spécifiez l’ID de locataire à utiliser.
-s, --sellerId	Spécifiez l’ID de vendeur à utiliser.
-c, --clientId	Spécifiez l’ID client à utiliser.
-cs, --clientSecret	Spécifiez le secret client qui doit être utilisé.
-ct, --empreinteNumériqueDuCertificat	Spécifiez l’empreinte numérique du certificat à utiliser.
-cfp, --certificateFilePath	Spécifiez le chemin d’accès au fichier de certificat qui doit être utilisé.
-cp, --certificatePassword	Spécifiez le mot de passe de certificat à utiliser.
--réinitialisation	Réinitialisez uniquement les informations d’identification, sans recommencer.
-v, --verbeux	Imprimer une sortie verbeuse.
-?, -h, --help	Affichez les informations d’aide et d’utilisation.

Commande des Paramètres

Modifiez les paramètres de l’interface CLI du développeur du Microsoft Store.

Usage

msstore settings

Options

Choix	Descriptif
-t, --activerLaTélémétrie	Activez (vide/true) ou désactivez la télémétrie (false).
-v, --verbeux	Imprimer une sortie verbeuse.
-?, -h, --help	Affichez les informations d’aide et d’utilisation.

SetPDN Sous-Commande

Définissez la propriété Nom affiché de l'Éditeur.

Usage

msstore settings setpdn <publisherDisplayName>

Arguments

Argument	Descriptif
publisherDisplayName	Propriété Nom d'affichage de l'éditeur qui sera définie globalement.

Options

Choix	Descriptif
-?, -h, --help	Affichez les informations d’aide et d’utilisation.

Commande de soumission

Sous-commande	Descriptif
statut	Obtient l’état d’une soumission.
get	Obtient les métadonnées et les informations de package d’une soumission spécifique.
getListingAssets	Obtient les éléments de liste d'une soumission spécifique.
updateMetadata	Met à jour les métadonnées d’une soumission spécifique.
update	Met à jour les informations de package d’une soumission spécifique.
sondage	Interroge l’état d’une soumission.
publier	Publie une soumission spécifique.

Soumission - État - Utilisation

msstore submission status <productId>

Arguments

Argument	Descriptif
productId	ID de l’Espace partenaires.

Options

Choix	Descriptif
-v, --verbeux	Imprimer une sortie verbeuse.
-?, -h, --help	Affichez les informations d’aide et d’utilisation.

Envoi - Récupération - Utilisation

msstore submission get <productId>

Arguments

Argument	Descriptif
productId	ID de l’Espace partenaires.

Options

Choix	Descriptif
-l, --langue	Sélectionnez la langue à récupérer. [default : en]
-v, --verbeux	Imprimer une sortie verbeuse.
-?, -h, --help	Affichez les informations d’aide et d’utilisation.

Soumission - GetListingAssets - Utilisation

msstore submission getListingAssets <productId>

Arguments

Argument	Descriptif
productId	ID de l’Espace partenaires.

Options

Choix	Descriptif
-l, --langue	Sélectionnez la langue à récupérer. [default : en]
-v, --verbeux	Imprimer une sortie verbeuse.
-?, -h, --help	Affichez les informations d’aide et d’utilisation.

Soumission - UpdateMetadata - Utilisation

msstore submission updateMetadata <productId> <metadata>

Arguments

Argument	Descriptif
productId	ID de l’Espace partenaires.
metadata	Représentation des métadonnées JSON mise à jour.

Options

Choix	Descriptif
-s, --ignorerLeSondageInitial	Ignorez l’interrogation initiale avant d’exécuter l’action. [valeur par défaut : False]
-v, --verbeux	Imprimer une sortie verbeuse.
-?, -h, --help	Affichez les informations d’aide et d’utilisation.

Soumission - Mise à jour - Utilisation

msstore submission update <productId> <package>

Arguments

Argument	Descriptif
productId	ID du Centre de Partenariat.
package	Représentation JSON mise à jour du package d’application.

Options

Choix	Descriptif
-s, --skipInitialPolling	Ignorez le sondage initial avant d’exécuter l’action. [valeur par défaut : False]
-v, --verbeux	Imprimer une sortie verbeuse.
-?, -h, --help	Affichez les informations d’aide et d’utilisation.

Soumission - Sondage - Utilisation

msstore submission poll <productId>

Arguments

Argument	Descriptif
productId	ID du Centre de Partenaires.

Options

Choix	Descriptif
-v, --verbeux	Imprimer une sortie verbeuse.
-?, -h, --help	Affichez les informations d’aide et d’utilisation.

Soumission - Publier - Utilisation

msstore submission publish <productId>

Arguments

Argument	Descriptif
productId	ID du Centre de partenariat.

Options

Choix	Descriptif
-v, --verbeux	Imprimer une sortie verbeuse.
-?, -h, --help	Affichez les informations d’aide et d’utilisation.

Environnements CI/CD

Microsoft Store Developer CLI (préversion) prend en charge l’exécution dans les environnements CI/CD. Cela signifie que vous pouvez utiliser l’interface CLI du développeur du Microsoft Store (préversion) dans vos pipelines CI/CD pour publier automatiquement vos applications dans le Microsoft Store.

La première étape pour y parvenir consiste à installer la CLI pour développeur du Microsoft Store (préversion) sur votre environnement CI/CD. Vous trouverez des instructions sur la façon de procéder ici.

Après avoir installé l’interface CLI du développeur du Microsoft Store (préversion), vous devez configurer votre environnement pour pouvoir exécuter des commandes. Pour ce faire, exécutez la msstore reconfigure commande avec les paramètres spécifiques qui identifient votre compte espace partenaires (TenantId, SellerId, ClientId). Vous devez également fournir un ClientSecret ou un certificat.

Il est très important de cacher ces informations d’identification, car elles seront visibles dans les logs de votre pipeline CI/CD. Pour ce faire, utilisez des secrets. Chaque système de pipeline CI/CD a des noms différents pour ces secrets. Par exemple, Azure DevOps les appelle variables secrètes, mais GitHub Action les appelle secrets chiffrés. Créez un secret pour chacun des paramètres (TenantId, SellerId, ClientId et ClientSecret ou certificat), puis utilisez la reconfigure commande pour configurer votre environnement.

Par exemple:

Azure DevOps

- task: UseMSStoreCLI@0
  displayName: Setup Microsoft Store Developer CLI
- script: msstore reconfigure --tenantId $(PARTNER_CENTER_TENANT_ID) --sellerId $(PARTNER_CENTER_SELLER_ID) --clientId $(PARTNER_CENTER_CLIENT_ID) --clientSecret $(PARTNER_CENTER_CLIENT_SECRET)
  displayName: Configure Microsoft Store Developer CLI

GitHub Actions

- name: Setup Microsoft Store Developer CLI
  uses: microsoft/microsoft-store-apppublisher@v1.1
- name: Configure Microsoft Store Developer CLI
  run: msstore reconfigure --tenantId ${{ secrets.PARTNER_CENTER_TENANT_ID }} --sellerId ${{ secrets.PARTNER_CENTER_SELLER_ID }} --clientId ${{ secrets.PARTNER_CENTER_CLIENT_ID }} --clientSecret ${{ secrets.PARTNER_CENTER_CLIENT_SECRET }}

Une fois cette commande exécutée, l’interface CLI du développeur du Microsoft Store (préversion) est configurée pour utiliser les informations d’identification fournies. Vous pouvez maintenant utiliser l’interface CLI pour développeurs du Microsoft Store (préversion) dans votre pipeline CI/CD.