Comandi (MSI/EXE)

Installazione

Passaggio 1: Installare .NET Windows Runtime

Se non è già stato fatto, installare la versione più recente di .NET 8 Desktop Runtime. Questo è un requisito per eseguire l'interfaccia della riga di comando per sviluppatori di Microsoft Store.

Il modo più semplice per installarlo consiste nell'usare winget:

winget install Microsoft.DotNet.DesktopRuntime.8

Passaggio 2: Installare l'interfaccia della riga di comando per sviluppatori di Microsoft Store in Windows

È possibile scaricare l'interfaccia della riga di comando per sviluppatori di Microsoft Store da Microsoft Store. In alternativa, è possibile usare winget:

winget install "Microsoft Store Developer CLI"

Passaggio 1: Installare il runtime macOS .NET

Se non è già stato fatto, installare la versione più recente del runtime di .NET 8. Questo è un requisito per eseguire l'interfaccia della riga di comando per sviluppatori di Microsoft Store.

Passaggio 2: Installare l'interfaccia della riga di comando per sviluppatori di Microsoft Store in macOS

È possibile scaricare il macOS .tar.gz per la vostra architettura specifica (x64 o Arm64) dalla pagina delle versioni di Microsoft Store Developer CLI. Una volta scaricato, estrarre l'archivio e aggiungerlo al PATH, come si preferisce, ad esempio:

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

In alternativa, è possibile usare brew:

brew install microsoft/msstore-cli/msstore-cli

Passaggio 1: Installare il runtime linux .NET

Se non è già stato fatto, installare la versione più recente del runtime di .NET 8. Questo è un requisito per eseguire l'interfaccia della riga di comando per sviluppatori di Microsoft Store.

Passaggio 2: Installare l'interfaccia della riga di comando per sviluppatori di Microsoft Store in Linux

È possibile scaricare il .tar.gz Linux per l'architettura specifica (x64 o Arm64) dalla pagina delle versioni dell'interfaccia della riga di comando per sviluppatori di Microsoft Store. Una volta scaricato, estrai l'archivio e inseriscilo nel PATH di sistema nel modo che preferisci, ad esempio:

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

In alternativa, è possibile usare brew:

brew install microsoft/msstore-cli/msstore-cli

Comando Info

Stampa la configurazione esistente.

Usage

msstore info

Options

Opzione	Description
-v, --verbose (dettagliato)	Stampare l'output dettagliato.
-?, -h, --help	Mostra informazioni di aiuto e utilizzo.

Riconfigurare il comando

Riconfigura la CLI per sviluppatori di Microsoft Store. È possibile specificare un segreto client o un certificato. I certificati possono essere forniti tramite impronta digitale o fornendo un percorso di file (con o senza password).

Usage

msstore reconfigure

Options

Opzione	Description
-t, --tenantId	Specificare l'ID tenant da usare.
-s, --sellerId (ID venditore)	Specificare l'ID venditore da usare.
-c, --clientId	Specificare l'ID client da usare.
-cs, --clientSecret	Specificare il segreto client da usare.
-ct, --certificateThumbprint	Specificare l'impronta digitale del certificato da usare.
-cfp, --certificateFilePath	Specificare il percorso del file del certificato da usare.
-cp, --certificatePassword (password del certificato)	Specificare la password del certificato da usare.
--ripristinare	Reimpostare solo le credenziali, senza ricominciare.
-v, --verbose	Stampare l'output dettagliato.
-?, -h, --help	Mostra informazioni di aiuto e utilizzo.

Comando delle Impostazioni

Modifica le impostazioni della CLI per sviluppatori di Microsoft Store.

Usage

msstore settings

Options

Opzione	Description
-t, --enableTelemetry	Abilitare (vuoto/true) o Disabilitare (false) i dati di telemetria.
-v, --verbose	Stampare l'output dettagliato.
-?, -h, --help	Mostra informazioni di aiuto e utilizzo.

SetPDN Sotto-Comando

Impostare la proprietà Nome visualizzato del Publisher.

Usage

msstore settings setpdn <publisherDisplayName>

Arguments

Argomentazione	Description
publisherDisplayName	Proprietà Nome visualizzato del Publisher che verrà impostata a livello globale.

Options

Opzione	Description
-?, -h, --help	Mostra informazioni di aiuto e utilizzo.

Comando invio

Sotto-comando	Description
stato	Ottiene lo stato di un invio.
get	Ottiene i metadati e le informazioni sul pacchetto di un invio specifico.
getListingAssets	Ottiene gli asset di presentazione di un invio specifico.
updateMetadata	Aggiorna i metadati di un invio specifico.
aggiornare	Aggiorna le informazioni sul pacchetto di un invio specifico.
scrutinio	Monitora lo stato di un invio.
pubblicare	Pubblica un invio specifico.

Invio - Stato - Utilizzo

msstore submission status <productId>

Arguments

Argomentazione	Description
productId	ID del Partner Center.

Options

Opzione	Description
-v, --verbose (dettagliato)	Stampare l'output dettagliato.
-?, -h, --help	Mostra informazioni di aiuto e utilizzo.

Invio - Ottieni - Utilizzo

msstore submission get <productId>

Arguments

Argomentazione	Description
productId	ID del Partner Center

Options

Opzione	Description
-l, --lingua	Selezionare la lingua da recuperare. [predefinito: it]
-v, --verbose (dettagliato)	Stampare l'output dettagliato.
-?, -h, --help	Mostra informazioni di aiuto e utilizzo.

Invio - GetListingAssets - Utilizzo

msstore submission getListingAssets <productId>

Arguments

Argomentazione	Description
productId	ID del Centro Partner

Options

Opzione	Description
-l, --language	Selezionare la lingua da recuperare. [predefinito: en]
-v, --verboso	Stampare l'output dettagliato.
-?, -h, --help	Mostra informazioni di aiuto e utilizzo.

Invio - Aggiorna metadati - Utilizzo

msstore submission updateMetadata <productId> <metadata>

Arguments

Argomentazione	Description
productId	ID del Centro Partner
metadata	Rappresentazione dei metadati JSON aggiornata.

Options

Opzione	Description
-s, --skipInitialPolling	Tralasciare il polling iniziale prima di eseguire l'azione. [impostazione predefinita: False]
-v, --verbose	Stampare l'output dettagliato.
-?, -h, --help	Mostra informazioni di aiuto e utilizzo.

Invio - Aggiornamento - Utilizzo

msstore submission update <productId> <package>

Arguments

Argomentazione	Description
productId	ID del Centro Partner
package	Rappresentazione JSON aggiornata del pacchetto dell'app.

Options

Opzione	Description
-s, --skipInitialPolling (salta l'interrogazione iniziale)	Ignorare il polling iniziale prima di eseguire l'azione. [impostazione predefinita: False]
-v, --verbose	Stampare l'output dettagliato.
-?, -h, --help	Mostra informazioni di aiuto e utilizzo.

Invio - Sondaggio - Utilizzo

msstore submission poll <productId>

Arguments

Argomentazione	Description
productId	ID del Centro Partner

Options

Opzione	Description
-v, --verbose	Stampare l'output dettagliato.
-?, -h, --help	Mostra informazioni di aiuto e utilizzo.

Invio - Pubblicazione - Utilizzo

msstore submission publish <productId>

Arguments

Argomentazione	Description
productId	ID del Centro Partner

Options

Opzione	Description
-v, --verbose	Stampare l'output dettagliato.
-?, -h, --help	Mostra informazioni di aiuto e utilizzo.

Ambienti CI/CD

L'interfaccia della riga di comando per sviluppatori di Microsoft Store (anteprima) supporta l'esecuzione in ambienti CI/CD. Ciò significa che è possibile usare l'interfaccia della riga di comando per sviluppatori di Microsoft Store (anteprima) nelle pipeline CI/CD per pubblicare automaticamente le applicazioni in Microsoft Store.

Il primo passaggio per ottenere questo risultato è installare la CLI per sviluppatori di Microsoft Store in anteprima nell'ambiente CI/CD. Per istruzioni su come eseguire questa operazione , vedere qui.

Dopo aver installato l'interfaccia della riga di comando per sviluppatori di Microsoft Store (anteprima), è necessario configurare l'ambiente per poter eseguire i comandi. A tale scopo, eseguire il comando con i parametri specifici che identificano l'account msstore reconfigure del Centro per i partner (TenantId, SellerId, ClientId). È anche necessario specificare un ClientSecret o un certificato.

È molto importante nascondere queste credenziali, perché saranno visibili nei log della pipeline CI/CD. A tale scopo, è possibile usare i segreti. Ogni sistema di pipeline CI/CD ha nomi diversi per questi segreti. Ad esempio, Azure DevOps li chiama Variabili segrete, ma GitHub Action li chiama Segreti crittografati. Creare un segreto per ognuno dei parametri (TenantId, SellerId, ClientId e ClientSecret o certificato) e quindi usare il comando per configurare l'ambiente. reconfigure

Per esempio:

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 }}

Dopo l'esecuzione di questo comando, l'interfaccia della riga di comando per sviluppatori di Microsoft Store (anteprima) verrà configurata per l'uso delle credenziali fornite. È ora possibile usare la CLI per sviluppatori di Microsoft Store (anteprima) nella pipeline CI/CD.