Installazione
Passaggio 1: Installare .NET Windows Runtime
Se non è già stato fatto, installare la versione più recente di .NET 9 Desktop Runtime. Si tratta di un requisito per eseguire la CLI per sviluppatori di Microsoft Store.
Il modo più semplice per installarlo è utilizzare winget:
winget install Microsoft.DotNet.DesktopRuntime.9
Passaggio 2: Installare l'interfaccia della riga di comando per sviluppatori di Microsoft Store in Windows
È possibile scaricare l'interfaccia della riga di comando di Microsoft Store Developer dalla Microsoft Store. In alternativa, puoi utilizzare winget:
winget install "Microsoft Store Developer CLI"
Passaggio 1: Installare .NET Runtime macOS
Se non l'hai già fatto, installa la versione più recente del .NET 9 Runtime. Si tratta di un requisito per eseguire la CLI per sviluppatori di Microsoft Store.
Passaggio 2: Installare l'interfaccia della riga di comando per sviluppatori Microsoft Store in macOS
È possibile scaricare il file .tar.gz per macOS relativo all'architettura specifica (x64 o Arm64) dalla pagina delle versioni CLI per sviluppatori di Microsoft Store. Una volta scaricato, estrai l'archivio e inseriscilo nel tuo PERCORSO, come preferisci, 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, puoi utilizzare brew:
brew install microsoft/msstore-cli/msstore-cli
Passaggio 1: Installare .NET Runtime Linux
Se non è già stato fatto, installare la versione più recente del .NET 9 Runtime. Si tratta di un requisito per eseguire la CLI per sviluppatori di Microsoft Store.
Passaggio 2: Installare l'interfaccia della riga di comando per sviluppatori Microsoft Store in Linux
È possibile scaricare Linux .tar.gz per l'architettura specifica (x64 o Arm64) dalla pagina dei rilasci del CLI di Microsoft Store Developer. Una volta scaricato, estrai l'archivio e inseriscilo nel tuo PERCORSO, come 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, puoi utilizzare brew:
brew install microsoft/msstore-cli/msstore-cli
Comando Info
Stampa la configurazione esistente.
Usage
msstore info
Options
| Opzione |
Descrizione |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Riconfigurare l'interfaccia della riga di comando 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 |
Descrizione |
| -t, --tenantId (identificatore del tenant) |
Specifica l'ID tenant da utilizzare. |
| -s, --IdVenditore |
Specifica l'ID venditore da utilizzare. |
| -c, --clientId (identificativoCliente) |
Specifica l'ID client da utilizzare. |
| -cs, --clientSecret |
Specifica il segreto client da utilizzare. |
| -ct, --improntaCertificato |
Specificare l'impronta digitale del certificato che deve essere utilizzato. |
| -cfp, --certificateFilePath |
Specificare il percorso del file del certificato da usare. |
| -cp, --certificatePassword (password del certificato) |
Specificare la password del certificato da usare. |
| --resettare |
Reimposta solo le credenziali, senza ricominciare da capo. |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Comando delle impostazioni
Modificare le impostazioni dell'interfaccia della riga di comando per sviluppatori Microsoft Store.
Usage
msstore settings
Options
| Opzione |
Descrizione |
| -t, --abilitaTelemetria |
Abilita (vuoto/vero) o disabilita (falso) la telemetria. |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
SetPDN Sotto-Comando
Imposta la proprietà Nome visualizzato dell'editore utilizzata dal comando init.
Usage
msstore settings setpdn <publisherDisplayName>
Argomenti
| Argomento |
Descrizione |
publisherDisplayName |
La proprietà Nome visualizzato del Publisher che verrà impostata a livello globale. |
Options
| Opzione |
Descrizione |
| -?, -h, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Comando Applicazioni
| Sottocomando |
Descrizione |
|
elenco |
Elenca tutte le applicazioni nel tuo account. |
|
Ottieni |
Ottiene i dettagli di un'applicazione specifica. |
App - Elenco - Uso
msstore apps list
Options
| Opzione |
Descrizione |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
App - Ottieni - Utilizzo
msstore apps get <productId>
Argomenti
| Argomento |
Descrizione |
productId |
L'ID prodotto del negozio. |
Options
| Opzione |
Descrizione |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Comando Invio
| Sottocomando |
Descrizione |
|
stato |
Ottiene lo stato di un invio. |
|
Ottieni |
Ottiene i metadati e le informazioni sul pacchetto di un invio specifico. |
|
getListingAssets |
Ottiene le risorse elencate di una sottomissione specifica. |
|
updateMetadata |
Aggiorna i metadati di un invio specifico. |
|
aggiornare |
Aggiorna il pacchetto di un invio specifico. |
|
sondaggio |
Esamina lo stato di un invio. |
|
pubblica |
Pubblica un invio specifico. |
|
eliminare |
Elimina un invio specifico. |
Invio - Stato - Utilizzo
msstore submission status <productId>
Argomenti
| Argomento |
Descrizione |
productId |
L'ID prodotto del negozio. |
Options
| Opzione |
Descrizione |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Invio - Ottieni - Utilizzo
msstore submission get <productId>
Argomenti
| Argomento |
Descrizione |
productId |
L'ID prodotto del negozio. |
Options
| Opzione |
Descrizione |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Invio - GetListingAssets - Utilizzo
msstore submission getListingAssets <productId>
Argomenti
| Argomento |
Descrizione |
productId |
L'ID prodotto del negozio. |
Options
| Opzione |
Descrizione |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
msstore submission updateMetadata <productId> <metadata>
Argomenti
| Argomento |
Descrizione |
productId |
L'ID prodotto del negozio. |
metadata |
Rappresentazione dei metadati JSON aggiornata. |
Options
| Opzione |
Descrizione |
| -s, --skipInitialPolling (salta il sondaggio iniziale) |
Saltare il polling iniziale prima di eseguire l'azione. [valore predefinito: Falso] |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Invio - Aggiornamento - Utilizzo
msstore submission update <productId> <package>
Argomenti
| Argomento |
Descrizione |
productId |
L'ID prodotto del negozio. |
package |
Rappresentazione JSON aggiornata del pacchetto dell'app. |
Options
| Opzione |
Descrizione |
| -s, --skipInitialPolling (salta il sondaggio iniziale) |
Saltare il polling iniziale prima di eseguire l'azione. [valore predefinito: Falso] |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Suggerimento
Usare submission get per recuperare il codice JSON del pacchetto corrente prima di chiamare submission update. In questo modo è possibile usare la struttura corretta e i valori correnti. Ad esempio, in 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
# Step 3: Pass the updated JSON to submission update
$updatedPackage = Get-Content -Raw package.json
msstore submission update <productId> $updatedPackage
Per altre informazioni di contesto, vedere Pubblicare gli aggiornamenti delle app per Microsoft Store con GitHub Actions.
Invio - Sondaggio - Utilizzo
msstore submission poll <productId>
Argomenti
| Argomento |
Descrizione |
productId |
L'ID prodotto del negozio. |
Options
| Opzione |
Descrizione |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Invio - Pubblicazione - Utilizzo
msstore submission publish <productId>
Argomenti
| Argomento |
Descrizione |
productId |
L'ID prodotto del negozio. |
Options
| Opzione |
Descrizione |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Invio - Eliminazione - Utilizzo
msstore submission delete <productId>
Argomenti
| Argomento |
Descrizione |
productId |
L'ID prodotto del negozio. |
Options
| Opzione |
Descrizione |
| --no-confirm |
Indica che non è richiesta la conferma. [valore predefinito: Falso] |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Comandi Volo
| Sottocomando |
Descrizione |
|
elenco |
Recupera tutti i voli per l'applicazione specificata. |
|
Ottieni |
Recupera un volo per l'applicazione specificata e il volo. |
|
eliminare |
Elimina un volo per l'applicazione e il volo specificati. |
|
create |
Crea un flight per l'applicazione e il flight specificati. |
|
presentazione |
Eseguire invii di progetti e attività correlate all'invio. |
Voli - Elencare l'utilizzo dei comandi
msstore flights list <productId>
Voli - Elencare gli argomenti dei comandi
| Argomento |
Descrizione |
productId |
ID prodotto. |
Voli - Guida ai comandi elenco
msstore flights list --help
Voli - Guida all'Uso dei Comandi
msstore flights get <productId> <flightId>
Voli - Estrarre argomenti di comando
| Argomento |
Descrizione |
productId |
ID prodotto. |
flightId |
ID del volo. |
Voli - Ottenere la Guida ai comandi
msstore flights get --help
Voli - Eliminare l'utilizzo dei comandi
msstore flights delete <productId> <flightId>
Voli - Elimina argomenti di comando
| Argomento |
Descrizione |
productId |
ID prodotto. |
flightId |
ID del volo. |
Voli - Eliminare la Guida ai comandi
msstore flights delete --help
Voli - Creare l'utilizzo dei comandi
msstore flights create <productId> <friendlyName> --group-ids <group-ids>
Voli - Creare parametri di comando
| Argomento |
Descrizione |
productId |
ID prodotto. |
friendlyName |
Nome amichevole del volo. |
Fasi di test - Crea opzioni di comando
| Opzione |
Descrizione |
| -g, --group-ids |
ID gruppi da associare al flight. |
| -r, --classificare-superiore-a |
ID del volo da classificare più in alto rispetto a. |
Voli - Guida per la creazione di comandi
msstore flights create --help
Voli - Comando di sottomissione
| Sottocomando |
Descrizione |
|
Ottieni |
Recupera l'invio esistente del pacchetto, cioè la bozza corrente o l'ultima versione pubblicata. |
|
eliminare |
Elimina l'invio in anteprima del pacchetto in sospeso dallo Store. |
|
aggiornare |
Aggiorna la bozza di anteprima esistente con il codice JSON fornito. |
|
pubblica |
Avvia il processo di invio in anteprima per la bozza esistente. |
|
sondaggio |
Esegue il polling fino a quando l'invio di volo esistente non è pubblicato o non è riuscito. |
|
stato |
Recupera lo stato corrente dell'invio del flight del negozio. |
|
Implementazione |
Eseguire operazioni relative al rollout di flight. |
Voli - Utilizzo del Comando Get
msstore flights submission get <productId> <flightId>
Voli - Argomenti del comando Get per la presentazione
| Argomento |
Descrizione |
productId |
ID prodotto. |
flightId |
ID del volo. |
Voli - Guida per ottenere il comando per l'invio
msstore flights submission get --help
Voli - Utilizzo dei comandi di eliminazione invio
msstore flights submission delete <productId> <flightId>
Voli - Argomenti di comando per l'eliminazione dell'invio
| Argomento |
Descrizione |
productId |
ID prodotto. |
flightId |
ID del volo. |
Voli - Guida per l'eliminazione dell'invio
msstore flights submission delete --help
Voli - Utilizzo dei comandi per l'aggiornamento dell'invio
msstore flights submission update <productId> <flightId> <product>
Voli - Argomenti del comando per l'aggiornamento dell'invio
| Argomento |
Descrizione |
productId |
ID prodotto. |
flightId |
ID del volo. |
product |
Rappresentazione del prodotto JSON aggiornata. |
Distribuzioni - Opzioni di comando per l'aggiornamento della sottomissione
| Opzione |
Descrizione |
| -s, --skipInitialPolling (salta il sondaggio iniziale) |
Saltare il polling iniziale prima di eseguire l'azione. [valore predefinito: Falso] |
Voli - Guida ai comandi per l'aggiornamento dell'invio
msstore flights submission update --help
Voli - Comando di Invio per la Pubblicazione
msstore flights submission publish <productId> <flightId>
Voli - Argomenti del comando di pubblicazione per l'invio
| Argomento |
Descrizione |
productId |
ID prodotto. |
flightId |
ID del volo. |
Voli - Guida ai comandi di pubblicazione per l'invio
msstore flights submission publish --help
Voli - Utilizzo dei comandi di sondaggio per l'invio
msstore flights submission poll <productId> <flightId>
Voli - Argomenti del comando poll per l'invio
| Argomento |
Descrizione |
productId |
ID prodotto. |
flightId |
ID del volo. |
Voli - Guida al comando di invio per il sondaggio
msstore flights submission poll --help
Voli - Utilizzo dei comandi stato di invio
msstore flights submission status <productId> <flightId>
Voli - Argomenti del comando Stato invio
| Argomento |
Descrizione |
productId |
ID prodotto. |
flightId |
ID del volo. |
Voli - Guida al comando Stato di invio
msstore flights submission status --help
Voli - Invio - Comando di implementazione
| Sottocomando |
Descrizione |
|
Ottieni |
Recupera lo stato del progressivo roll-out di una presentazione. |
|
aggiornare |
Aggiornare la percentuale di distribuzione di un invio. |
|
Arresto |
Interrompe il rollout graduale di una sottomissione. |
|
finalizzare |
Finalizza il rilascio graduale di una consegna. |
Voli - Invio - Distribuzione Uso del Comando Get
msstore flights submission rollout get <productId> <flightId>
Voli - Invio - Distribuzione Argomenti del Comando Get
| Argomento |
Descrizione |
productId |
ID prodotto. |
flightId |
ID del volo. |
Voli - Invio - Implementazione Get Command Options
| Opzione |
Descrizione |
| -s, --idSottomissione |
ID di invio. |
Voli - Invio - Implementazione - Ottieni Aiuto Comando
msstore flights submission rollout get --help
Voli - Invio - Distribuzione dell'utilizzo dei comandi di aggiornamento
msstore flights submission rollout update <productId> <flightId> <percentage>
Voli - Invio - Argomenti dei comandi di aggiornamento dell'implementazione
| Argomento |
Descrizione |
productId |
ID prodotto. |
flightId |
ID del volo. |
percentage |
Percentuale di utenti che riceveranno la distribuzione dell'invio. |
Voli - Invio - Opzioni dei comandi di aggiornamento distribuzione
| Opzione |
Descrizione |
| -s, --idSottomissione |
ID di invio. |
Voli - Invio - Guida ai comandi di aggiornamento dell'implementazione
msstore flights submission rollout update --help
Voli - Invio - Implementazione interrompi utilizzo dei comandi
msstore flights submission rollout halt <productId> <flightId>
Fasi di rilascio - Invio - Argomenti del comando di arresto distribuzione
| Argomento |
Descrizione |
productId |
ID prodotto. |
flightId |
ID del volo. |
Voli - Invio - Implementazione interrompi opzioni comando
| Opzione |
Descrizione |
| -s, --idSottomissione |
ID di invio. |
Voli - Invio - Guida al comando per fermare il rollout
msstore flights submission rollout halt --help
Voli - Invio - Implementazione finalizzare l'utilizzo dei comandi
msstore flights submission rollout finalize <productId> <flightId>
Voli - Invio - Implementazione finalizza argomenti di comando
| Argomento |
Descrizione |
productId |
ID prodotto. |
flightId |
ID del volo. |
Versioni - Sottomissione - Opzioni di Comando per la Finalizzazione del Rollout
| Opzione |
Descrizione |
| -s, --idSottomissione |
ID di invio. |
Voli - Trasmissione - Implementazione Completamento Guida ai comandi
msstore flights submission rollout finalize --help
Comando Init
Il comando init consente di configurare l'applicazione per la pubblicazione nel Microsoft Store. Attualmente supporta i seguenti tipi di applicazioni:
- WinUI
- .NET MAUI
- Flutter
- Elettrone
- React Native per desktop
- PWA
- UWP (Piattaforma Universale Windows)
Esempi di utilizzo
SDK per app di Windows/WinUI
msstore init "C:\path\to\winui3_app"
UWP (Piattaforma Universale Windows)
msstore init "C:\path\to\uwp_app"
.NET MAUI
msstore init "C:\path\to\maui_app"
Flutter
msstore init "C:\path\to\flutter_app"
Elettrone
msstore init "C:\path\to\electron_app"
React Native per desktop
msstore init "C:\path\to\react_native_app"
Nota
Per Electron, nonché React Native per i progetti desktop, sono supportati sia Npm che Yarn . La presenza del Yarn file di blocco (yarn.lock) verrà usata per determinare quale gestione pacchetti usare, quindi assicurarsi di archiviare il file di blocco nel sistema di controllo del codice sorgente.
PWA
msstore init https://contoso.com --output .
Argomenti
| Argomento |
Descrizione |
pathOrUrl |
Il percorso della directory principale in cui si trova il file di progetto o un URL pubblico che punta a una PWA. |
Options
| Opzione |
Descrizione |
| -n, --publisherDisplayName |
Nome visualizzato del Publisher utilizzato per configurare l'applicazione. Se fornito, evita una chiamata API aggiuntiva. |
| --pacchetto |
Se il tipo di app lo supporta, impacchetta automaticamente il progetto. |
| --pubblicare |
Se supportato dal tipo di app, pubblica automaticamente il progetto. Implica '--package true' |
| -f, --idVolo |
Specifica l'ID volo in cui verrà pubblicato il pacchetto. |
| -prp, --percentualeDistribuzionePacchetto |
Specifica la percentuale di implementazione del pacchetto. Il valore deve essere compreso tra 0 e 100. |
| -a, --arch |
Le architetture in relazione alle quali creare. Se non fornita, verrà utilizzata l'architettura predefinita per il sistema operativo corrente e il tipo di progetto. Valori consentiti: "x86", "x64", "arm64". Viene utilizzato solo insieme a '--package true'. |
| -o, --uscita |
La directory di output in cui verrà archiviata l'app in pacchetto. Se non fornita, verrà utilizzata la directory predefinita per ogni diverso tipo di app. |
| -ver, --versione |
La versione utilizzata durante la creazione dell'app. Se non fornita, verrà utilizzata la versione del file di progetto. |
Comando Pacchetto
Consente di creare un pacchetto dell'applicazione Microsoft Store come MSIX.
Esempi di utilizzo
SDK per app di Windows/WinUI
msstore package "C:\path\to\winui3_app"
WinUI
msstore package "C:\path\to\uwp_app"
.NET MAUI
msstore package "C:\path\to\maui_app"
Flutter
msstore package "C:\path\to\flutter_app"
Elettrone
msstore package "C:\path\to\electron_app"
React Native per desktop
msstore package "C:\path\to\react_native_app"
PWA
msstore package "C:\path\to\pwa_app"
Argomenti
| Opzione |
Descrizione |
pathOrUrl |
Il percorso della directory principale in cui si trova il file di progetto o un URL pubblico che punta a una PWA. |
Options
| Opzione |
Descrizione |
| -o, --uscita |
La directory di output in cui verrà archiviata l'app in pacchetto. Se non fornita, verrà utilizzata la directory predefinita per ogni diverso tipo di app. |
| -a, --arch |
Le architetture in relazione alle quali creare. Se non fornita, verrà utilizzata l'architettura predefinita per il sistema operativo corrente e il tipo di progetto. Valori consentiti: "x86", "x64", "arm64". |
| -ver, --version |
La versione utilizzata durante la creazione dell'app. Se non fornita, verrà utilizzata la versione del file di progetto. |
Comando Publish
Pubblica l'applicazione nel Microsoft Store.
Esempi di utilizzo
SDK per app di Windows/WinUI
msstore publish "C:\path\to\winui3_app"
WinUI
msstore publish "C:\path\to\uwp_app"
.NET MAUI
msstore publish "C:\path\to\maui_app"
Flutter
msstore publish "C:\path\to\flutter_app"
Elettrone
msstore publish "C:\path\to\electron_app"
React Native per desktop
msstore publish "C:\path\to\react_native_app"
PWA
msstore publish "C:\path\to\pwa_app"
Argomenti
| Opzione |
Descrizione |
pathOrUrl |
Il percorso della directory principale in cui si trova il file di progetto o un URL pubblico che punta a una PWA. |
Options
| Opzione |
Descrizione |
| -i, --file di input |
Percorso del file '.msix' o '.msixupload' da usare per il comando di pubblicazione. Se non fornito, la CLI proverà a trovare il miglior candidato in base all'argomento 'pathOrUrl'. |
| -id, --appId (identificativo applicazione) |
Specifica l'ID dell'applicazione. Necessario solo se il progetto non è stato inizializzato in precedenza con il comando 'init'. |
| -nc, --noCommit (nessuna conferma di commit) |
Disabilita la conferma dell'invio, mantenendolo allo stato di bozza. |
| -f, --idVolo |
Specifica l'ID volo in cui verrà pubblicato il pacchetto. |
| -prp, --percentualeDistribuzionePacchetto |
Specifica la percentuale di implementazione del pacchetto. Il valore deve essere compreso tra 0 e 100. |
Comando Voli
| Sottocomando |
Descrizione |
|
elenco |
Recupera tutti i voli per l'applicazione specificata. |
|
Ottieni |
Recupera un volo per l'applicazione specificata e il volo. |
|
eliminare |
Elimina un volo per l'applicazione e il volo specificati. |
|
create |
Crea un flight per l'applicazione e il flight specificati. |
|
presentazione |
Eseguire invii di progetti e attività correlate all'invio. |
Voli - Elenco - Utilizzo
msstore flights list <productId>
Argomenti
| Argomento |
Descrizione |
productId |
ID prodotto. |
Options
| Opzione |
Descrizione |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Voli - Ottieni - Utilizzo
msstore flights get <productId> <flightId>
Argomenti
| Argomento |
Descrizione |
productId |
ID prodotto. |
flightId |
ID del volo. |
Options
| Opzione |
Descrizione |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Voli - Eliminazione - Utilizzo
msstore flights delete <productId> <flightId>
Argomenti
| Argomento |
Descrizione |
productId |
ID prodotto. |
flightId |
ID del volo. |
Options
| Opzione |
Descrizione |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Voli - Crea - Utilizzo
msstore flights create <productId> <friendlyName> --group-ids <group-ids>
Argomenti
| Argomento |
Descrizione |
productId |
ID prodotto. |
friendlyName |
Nome amichevole del volo. |
Options
| Opzione |
Descrizione |
| -g, --group-ids |
ID gruppi da associare al flight. |
| -r, --classificare-superiore-a |
ID del volo da classificare più in alto rispetto a. |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Voli - Invio
| Sottocomando |
Descrizione |
|
Ottieni |
Recupera l'invio esistente del pacchetto, cioè la bozza corrente o l'ultima versione pubblicata. |
|
eliminare |
Elimina l'invio in anteprima del pacchetto in sospeso dallo Store. |
|
aggiornare |
Aggiorna la bozza di anteprima esistente con il codice JSON fornito. |
|
pubblica |
Avvia il processo di invio in anteprima per la bozza esistente. |
|
sondaggio |
Esegue il polling fino a quando l'invio di volo esistente non è pubblicato o non è riuscito. |
|
stato |
Recupera lo stato corrente dell'invio del flight del negozio. |
|
Implementazione |
Eseguire operazioni relative al rollout di flight. |
Voli - Invio - Ottenere - Utilizzo
msstore flights submission get <productId> <flightId>
Argomenti
| Argomento |
Descrizione |
productId |
ID prodotto. |
flightId |
ID del volo. |
Options
| Opzione |
Descrizione |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Voli - Invio - Eliminazione - Utilizzo
msstore flights submission delete <productId> <flightId>
Argomenti
| Argomento |
Descrizione |
productId |
ID prodotto. |
flightId |
ID del volo. |
Options
| Opzione |
Descrizione |
| --no-confirm |
Indica che non è richiesta la conferma. |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Voli - Invio - Aggiornamento - Utilizzo
msstore flights submission update <productId> <flightId> <product>
Argomenti
| Argomento |
Descrizione |
productId |
ID prodotto. |
flightId |
ID del volo. |
product |
Rappresentazione del prodotto JSON aggiornata. |
Options
| Opzione |
Descrizione |
| -s, --skipInitialPolling (salta il sondaggio iniziale) |
Saltare il polling iniziale prima di eseguire l'azione. [valore predefinito: Falso] |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Voli - Invio - Pubblicazione - Utilizzo
msstore flights publish <productId> <flightId>
Argomenti
| Argomento |
Descrizione |
productId |
ID prodotto. |
flightId |
ID del volo. |
Options
| Opzione |
Descrizione |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Voli - Invio - Sondaggio - Utilizzo
msstore flights poll <productId> <flightId>
Argomenti
| Argomento |
Descrizione |
productId |
ID prodotto. |
flightId |
ID del volo. |
Options
| Opzione |
Descrizione |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Voli - Invio - Stato - Utilizzo
msstore flights status <productId> <flightId>
Argomenti
| Argomento |
Descrizione |
productId |
ID prodotto. |
flightId |
ID del volo. |
Options
| Opzione |
Descrizione |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Voli - Invio - Distribuzione
| Sottocomando |
Descrizione |
|
Ottieni |
Recupera lo stato del progressivo roll-out di una presentazione. |
|
aggiornare |
Aggiornare la percentuale di distribuzione di un invio. |
|
Arresto |
Interrompe il rollout graduale di una sottomissione. |
|
finalizzare |
Finalizza il rilascio graduale di una consegna. |
Voli - Invio - Rilascio - Ottieni - Utilizzo
msstore flights submission rollout get <productId> <flightId>
Argomenti
| Argomento |
Descrizione |
productId |
ID prodotto. |
flightId |
ID del volo. |
Options
| Opzione |
Descrizione |
| -s, --idSottomissione |
ID di invio. |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Voli - Invio - Distribuzione - Aggiornamento - Utilizzo
msstore flights submission rollout update <productId> <flightId> <percentage>
Argomenti
| Argomento |
Descrizione |
productId |
ID prodotto. |
flightId |
ID del volo. |
percentage |
Percentuale di utenti che riceveranno la distribuzione dell'invio. |
Options
| Opzione |
Descrizione |
| -s, --idSottomissione |
ID di invio. |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Voli - Invio - Implementazione - Interruzione - Utilizzo
msstore flights submission rollout halt <productId> <flightId>
Argomenti
| Argomento |
Descrizione |
productId |
ID prodotto. |
flightId |
ID del volo. |
Options
| Opzione |
Descrizione |
| -s, --idSottomissione |
ID di invio. |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Voli - Invio - Distribuzione - Finalizzazione - Utilizzo
msstore flights submission rollout finalize <productId> <flightId>
Argomenti
| Argomento |
Descrizione |
productId |
ID prodotto. |
flightId |
ID del volo. |
Options
| Opzione |
Descrizione |
| -s, --idSottomissione |
ID di invio. |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Ambienti CI/CD
L'interfaccia della riga di comando di Microsoft Store developer (anteprima) supporta l'esecuzione in ambienti CI/CD. Ciò significa che è possibile usare la CLI per sviluppatori del Microsoft Store (anteprima) nelle pipeline CI/CD per, ad esempio, pubblicare automaticamente le applicazioni nel Microsoft Store.
Il primo passaggio per ottenere questo risultato è installare la CLI sviluppatore di Microsoft Store (versione di anteprima) nell'ambiente CI/CD. Puoi trovare le istruzioni su come fare qui.
Dopo aver installato l'interfaccia della riga di comando per sviluppatori 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, poiché saranno visibili nei log della pipeline CI/CD. Puoi farlo utilizzando le chiavi private. Ogni sistema di pipeline CI/CD ha nomi diversi per questi segreti. Ad esempio, Azure DevOps chiamarli Secret Variables, ma GitHub Action li chiama Encrypted Secrets. Creare un segreto per ognuno dei parametri (TenantId, SellerId, ClientId e ClientSecret o certificato) e quindi usare il comando per configurare l'ambientereconfigure.
Ad 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 Microsoft Store (anteprima) verrà configurata per l'uso delle credenziali fornite. Ora puoi utilizzare il Microsoft Store Developer CLI (anteprima) nella tua pipeline CI/CD.
