Commandes (MSI/EXE)

Installation

Étape 1 : Installer .NET Windows Runtime

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

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

winget install Microsoft.DotNet.DesktopRuntime.8

Étape 2 : Installer l'interface en ligne de commande du développeur de Microsoft Store sur Windows

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

winget install "Microsoft Store Developer CLI"

Étape 1 : Installer .NET runtime macOS

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

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

Vous pouvez télécharger le macOS .tar.gz pour votre architecture spécifique (x64 ou Arm64) à partir de la page des versions Microsoft Store Developer CLI. 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 .NET Runtime Linux

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

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

Vous pouvez télécharger le fichier .tar.gz Linux pour votre architecture spécifique (x64 ou Arm64) à partir de la page des versions de l’interface CLI développeur 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
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, --verbose Imprimez une sortie détaillée.
-?, -h, --aide Affichez les informations d’aide et d’utilisation.

Reconfigurer la commande

Configurez à nouveau l’interface CLI Microsoft Store développeur. 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, --tenantId 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, --certificateThumbprint Spécifiez l’empreinte numérique du certificat à utiliser.
-cfp, --certificateFilePath (chemin d'accès au fichier de certificat) Spécifiez le chemin d’accès au fichier de certificat qui doit être utilisé.
-cp, --motDePasseDuCertificat Spécifiez le mot de passe de certificat à utiliser.
--reset Réinitialisez uniquement les informations d’identification, sans recommencer.
-v, --verbose Imprimez une sortie détaillée.
-?, -h, --aide Affichez les informations d’aide et d’utilisation.

Commande des Paramètres

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

Usage

msstore settings

Options

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

Sous-Commande SetPDN

Définissez la propriété Nom complet de l’éditeur.

Usage

msstore settings setpdn <publisherDisplayName>

Arguments

Argument Descriptif
publisherDisplayName La propriété Nom complet de l’éditeur qui sera définie globalement.

Options

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

Commande Submission

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 ressources de référencement d’une soumission spécifique.
updateMetadata Met à jour les métadonnées d’une soumission spécifique.
mise à jour 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, --verbose Imprimez une sortie détaillée.
-?, -h, --aide 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, --verbose Imprimez une sortie détaillée.
-?, -h, --aide 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, --verbose Imprimez une sortie détaillée.
-?, -h, --aide 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, --verbose Imprimez une sortie détaillée.
-?, -h, --aide Affichez les informations d’aide et d’utilisation.

Soumission - Mise à jour - Utilisation

msstore submission update <productId> <package>

Arguments

Argument Descriptif
productId ID de l’Espace partenaires.
package Représentation JSON mise à jour du package d’application.

Options

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

Conseil / Astuce

Permet submission get de récupérer le json du package actuel avant d’appeler submission update. Cela garantit que vous travaillez avec la structure et les valeurs actuelles correctes. Par exemple, dans PowerShell :

# Step 1: Retrieve the current submission package JSON
msstore submission get <productId> | Out-File -Encoding utf8 package.json

# Step 2: Edit package.json to reflect your changes (for example, a new installer URL)

# Step 3: Pass the updated JSON to submission update
$updatedPackage = Get-Content -Raw package.json
msstore submission update <productId> $updatedPackage

Pour plus de contexte, consultez Publiez les mises à jour d'applications sur le Microsoft Store avec GitHub Actions.

Soumission - Sondage - Utilisation

msstore submission poll <productId>

Arguments

Argument Descriptif
productId ID de l’Espace partenaires.

Options

Choix Descriptif
-v, --verbose Imprimez une sortie détaillée.
-?, -h, --aide Affichez les informations d’aide et d’utilisation.

Soumission - Publier - Utilisation

msstore submission publish <productId>

Arguments

Argument Descriptif
productId ID de l’Espace partenaires.

Options

Choix Descriptif
-v, --verbose Imprimez une sortie détaillée.
-?, -h, --aide Affichez les informations d’aide et d’utilisation.

Environnements CI/CD

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

La première étape pour y parvenir est d’installer le CLI de développeur 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 développeur 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 Secret Variables, 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 Microsoft Store développeur (préversion) est configurée pour utiliser les informations d’identification fournies. Vous pouvez maintenant utiliser la CLI Microsoft Store Developer (en préversion) dans votre pipeline CI/CD.

  • Dernière mise à jour :