Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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 la CLI 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 di Microsoft Store Developer dalla Microsoft Store. In alternativa, è possibile usare winget:
winget install "Microsoft Store Developer CLI"
Passaggio 1: Installare .NET Runtime macOS
Se non è già stato fatto, installare la versione più recente di .NET 8 Runtime. Questo è 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, 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 .NET Runtime Linux
Se non l'hai già fatto, installa la versione più recente del .NET 8 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, estrarre l'archivio e aggiungerlo al PATH, come si preferisce, 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, --aiuto | Mostra informazioni di aiuto e utilizzo. |
Riconfigurare il comando
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 | Description |
|---|---|
| -t, --tenantId (identificatore del tenant) | Specificare l'ID tenant da usare. |
| -s, --sellerId (ID venditore) | Specificare l'ID venditore da usare. |
| -c, --clientId (identificativoCliente) | Specificare l'ID client da usare. |
| -cs, --clientSecret | Specificare il segreto client da usare. |
| -ct, --improntaCertificato | 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 (dettagliato) | Stampare l'output dettagliato. |
| -?, -h, --aiuto | Mostra informazioni di aiuto e utilizzo. |
Comando delle Impostazioni
Modificare le impostazioni dell'interfaccia della riga di comando per sviluppatori Microsoft Store.
Usage
msstore settings
Options
| Opzione | Description |
|---|---|
| -t, --abilitaTelemetria | Abilitare (vuoto/true) o Disabilitare (false) i dati di telemetria. |
| -v, --verbose (dettagliato) | Stampare l'output dettagliato. |
| -?, -h, --aiuto | 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 |
La proprietà Nome visualizzato del Publisher che verrà impostata a livello globale. |
Options
| Opzione | Description |
|---|---|
| -?, -h, --aiuto | 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, --aiuto | 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, --aiuto | Mostra informazioni di aiuto e utilizzo. |
Invio - GetListingAssets - Utilizzo
msstore submission getListingAssets <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, --aiuto | Mostra informazioni di aiuto e utilizzo. |
Invio - Aggiorna metadati - Utilizzo
msstore submission updateMetadata <productId> <metadata>
Arguments
| Argomentazione | Description |
|---|---|
productId |
ID del Partner Center. |
metadata |
Rappresentazione dei metadati JSON aggiornata. |
Options
| Opzione | Description |
|---|---|
| -s, --skipInitialPolling (salta il sondaggio iniziale) | Tralasciare il polling iniziale prima di eseguire l'azione. [impostazione predefinita: False] |
| -v, --verbose (dettagliato) | Stampare l'output dettagliato. |
| -?, -h, --aiuto | Mostra informazioni di aiuto e utilizzo. |
Invio - Aggiornamento - Utilizzo
msstore submission update <productId> <package>
Arguments
| Argomentazione | Description |
|---|---|
productId |
ID del Partner Center. |
package |
Rappresentazione JSON aggiornata del pacchetto dell'app. |
Options
| Opzione | Description |
|---|---|
| -s, --skipInitialPolling (salta il sondaggio iniziale) | Tralasciare il polling iniziale prima di eseguire l'azione. [impostazione predefinita: False] |
| -v, --verbose (dettagliato) | Stampare l'output dettagliato. |
| -?, -h, --aiuto | Mostra informazioni di 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 (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
Per altre informazioni di contesto, vedere Pubblicare gli aggiornamenti delle app per Microsoft Store con GitHub Actions.
Invio - Sondaggio - Utilizzo
msstore submission poll <productId>
Arguments
| Argomentazione | Description |
|---|---|
productId |
ID del Partner Center. |
Options
| Opzione | Description |
|---|---|
| -v, --verbose (dettagliato) | Stampare l'output dettagliato. |
| -?, -h, --aiuto | Mostra informazioni di aiuto e utilizzo. |
Invio - Pubblicazione - Utilizzo
msstore submission publish <productId>
Arguments
| Argomentazione | Description |
|---|---|
productId |
ID del Partner Center. |
Options
| Opzione | Description |
|---|---|
| -v, --verbose (dettagliato) | Stampare l'output dettagliato. |
| -?, -h, --aiuto | Mostra informazioni di 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. Per istruzioni su come eseguire questa operazione , vedere 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, 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 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'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 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.
Collabora con noi su GitHub
L'origine di questo contenuto è disponibile in GitHub, in cui è anche possibile creare ed esaminare i problemi e le richieste pull. Per ulteriori informazioni, vedere la guida per i collaboratori.
