Comandos (MSI/EXE)

Installation

Etapa 1: Instalar .NET Windows Runtime

Se você ainda não fez isso, instale a versão mais recente do .NET 8 Desktop Runtime. Esse é um requisito para executar a CLI do desenvolvedor do Microsoft Store.

A maneira mais fácil de instalá-lo é usar winget:

winget install Microsoft.DotNet.DesktopRuntime.8

Etapa 2: instalar a CLI do desenvolvedor do Microsoft Store no Windows

Você pode baixar a CLI do Desenvolvedor da Microsoft Store no Microsoft Store. Como alternativa, você pode usar winget:

winget install "Microsoft Store Developer CLI"

Etapa 1: Instalar .NET runtime do macOS

Se você ainda não fez isso, instale a versão mais recente do .NET 8 Runtime. Esse é um requisito para executar a CLI do desenvolvedor do Microsoft Store.

Etapa 2: Instalar a CLI do desenvolvedor do Microsoft Store no macOS

Você pode baixar o arquivo macOS .tar.gz para sua arquitetura específica (x64 ou Arm64) na página de lançamentos do CLI do Desenvolvedor do Microsoft Store. Depois de baixado, extraia o arquivo e coloque-o em seu PATH, da maneira que preferir.

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

Como alternativa, você pode usar brew:

brew install microsoft/msstore-cli/msstore-cli

Etapa 1: Instalar .NET Runtime do Linux

Se você ainda não fez isso, instale a versão mais recente do .NET 8 Runtime. Esse é um requisito para executar a CLI do desenvolvedor do Microsoft Store.

Etapa 2: Instalar a CLI do desenvolvedor Microsoft Store no Linux

Você pode baixar o Linux .tar.gz para a sua arquitetura específica (x64 ou Arm64) na página de versões da CLI do Desenvolvedor do Microsoft Store. Depois de baixado, extraia o arquivo e coloque-o em seu PATH, da maneira que preferir.

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

Como alternativa, você pode usar brew:

brew install microsoft/msstore-cli/msstore-cli

Comando Info

Imprima a configuração existente.

Usage

msstore info

Opções

Opção Description
-v, --verbose (modo detalhado) Imprimir saída detalhada.
-?, -h, --help (ajuda) Mostrar informações de ajuda e uso.

Reconfigurar Comando

Configure novamente a CLI do Desenvolvedor do Microsoft Store. Você pode fornecer um segredo do cliente ou um certificado. Os certificados podem ser fornecidos por meio de sua Impressão Digital ou fornecendo um caminho de arquivo (com ou sem uma senha).

Usage

msstore reconfigure

Opções

Opção Description
-t, --idLocatario Especifique a ID do locatário que deve ser usada.
-s, --IdDoVendedor Especifique a ID do vendedor que deve ser usada.
-c, --identificadorDoCliente Especifique a ID do cliente que deve ser usada.
-cs, --segredoDoCliente Especifique o segredo do cliente que deve ser usado.
-ct, --certificateThumbprint (impressão digital do certificado) Especifique a impressão digital do certificado que deve ser usada.
-cfp, --certificateFilePath Especifique o caminho do arquivo de certificado que deve ser usado.
-cp, --certificatePassword Especifique a senha do certificado que deve ser usada.
--reiniciar Redefina apenas as credenciais, sem recomeçar.
-v, --verbose (modo detalhado) Imprimir saída detalhada.
-?, -h, --help (ajuda) Mostrar informações de ajuda e uso.

Comando de Configurações

Altere as configurações da CLI do Desenvolvedor do Microsoft Store.

Usage

msstore settings

Opções

Opção Description
-t, --enableTelemetry (habilitar telemetria) Habilitar (vazia/verdadeira) ou desabilitar a telemetria (false).
-v, --verbose (modo detalhado) Imprimir saída detalhada.
-?, -h, --help (ajuda) Mostrar informações de ajuda e uso.

Comando secundário SetPDN

Defina a propriedade Nome de Exibição do Publisher.

Usage

msstore settings setpdn <publisherDisplayName>

Arguments

Argument Description
publisherDisplayName Propriedade Nome de Exibição do Publicador que será definida globalmente.

Opções

Opção Description
-?, -h, --help (ajuda) Mostrar informações de ajuda e uso.

Comando envio

Sub-Command Description
estado Obtém o status de um envio.
Obter Obtém os metadados e as informações do pacote de um envio específico.
getListingAssets Obtém os ativos de listagem de um envio específico.
updateMetadata Atualiza os metadados de um envio específico.
atualizar Atualiza as informações do pacote de um envio específico.
enquete Sonda o status de uma submissão.
publish Publica uma submissão específica.

Envio – Status – Uso

msstore submission status <productId>

Arguments

Argument Description
productId O ID do Centro de Parceiros.

Opções

Opção Description
-v, --verbose (modo detalhado) Imprimir saída detalhada.
-?, -h, --help (ajuda) Mostrar informações de ajuda e uso.

Envio – Obter – Uso

msstore submission get <productId>

Arguments

Argument Description
productId O ID do Centro de Parceiros.

Opções

Opção Description
-l, --idioma Selecione qual idioma você deseja recuperar. [padrão: en]
-v, --verbose (modo detalhado) Imprimir saída detalhada.
-?, -h, --help (ajuda) Mostrar informações de ajuda e uso.

Envio – GetListingAssets – Uso

msstore submission getListingAssets <productId>

Arguments

Argument Description
productId O ID do Centro de Parceiros.

Opções

Opção Description
-l, --idioma Selecione qual idioma você deseja recuperar. [padrão: en]
-v, --verbose (modo detalhado) Imprimir saída detalhada.
-?, -h, --help (ajuda) Mostrar informações de ajuda e uso.

Envio – AtualizarMetadados – Uso

msstore submission updateMetadata <productId> <metadata>

Arguments

Argument Description
productId O ID do Centro de Parceiros.
metadata A representação de metadados JSON atualizada.

Opções

Opção Description
-s, --skipInitialPolling (ignorar a sondagem inicial) Ignore a sondagem inicial antes de executar a ação. [padrão: False]
-v, --verbose (modo detalhado) Imprimir saída detalhada.
-?, -h, --help (ajuda) Mostrar informações de ajuda e uso.

Envio – Atualização – Uso

msstore submission update <productId> <package>

Arguments

Argument Description
productId O ID do Centro de Parceiros.
package A representação JSON atualizada do pacote do aplicativo.

Opções

Opção Description
-s, --skipInitialPolling (ignorar a sondagem inicial) Ignore a sondagem inicial antes de executar a ação. [padrão: False]
-v, --verbose (modo detalhado) Imprimir saída detalhada.
-?, -h, --help (ajuda) Mostrar informações de ajuda e uso.

Dica

Use submission get para recuperar o JSON do pacote atual antes de chamar submission update. Isso garante que você esteja trabalhando com a estrutura correta e os valores atuais. Por exemplo, no 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

Para obter mais contexto, consulte Publish atualizações de aplicativo para Microsoft Store com GitHub Actions.

Envio – Votação – Uso

msstore submission poll <productId>

Arguments

Argument Description
productId O ID do Centro de Parceiros.

Opções

Opção Description
-v, --verbose (modo detalhado) Imprimir saída detalhada.
-?, -h, --help (ajuda) Mostrar informações de ajuda e uso.

Envio – Publicar – Uso

msstore submission publish <productId>

Arguments

Argument Description
productId O ID do Centro de Parceiros.

Opções

Opção Description
-v, --verbose (modo detalhado) Imprimir saída detalhada.
-?, -h, --help (ajuda) Mostrar informações de ajuda e uso.

Ambientes de CI/CD

A CLI do Desenvolvedor do Microsoft Store (versão prévia) dá suporte à execução em ambientes de CI/CD. Isso significa que você pode usar a CLI do Desenvolvedor do Microsoft Store (versão prévia) em seus pipelines de CI/CD para, por exemplo, publicar automaticamente seus aplicativos no Microsoft Store.

O primeiro passo para alcançar isso é instalar a CLI do Desenvolvedor do Microsoft Store (versão de prévia) no seu ambiente de CI/CD. Você pode encontrar instruções sobre como fazer isso aqui.

Depois de instalar a CLI do Desenvolvedor do Microsoft Store (versão prévia), você precisa configurar seu ambiente para poder executar comandos. Você pode fazer isso executando o msstore reconfigure comando com os parâmetros específicos que identificam sua conta do partner center (TenantId, SellerId, ClientId). Você também precisa fornecer um ClientSecret ou um certificado.

É muito importante ocultar essas credenciais, pois elas estarão visíveis nos registros do pipeline de CI/CD. Você pode fazer isso usando segredos. Cada sistema de pipeline de CI/CD tem nomes diferentes para esses segredos. Por exemplo, Azure DevOps as chama Secret Variables, mas GitHub Actions as chama de Encrypted Secrets. Crie um segredo para cada um dos parâmetros (TenantId, SellerId, ClientId e ClientSecret ou um Certificado) e use o reconfigure comando para configurar seu ambiente.

Por exemplo:

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

Depois que esse comando for executado, a CLI do desenvolvedor do Microsoft Store (versão prévia) será configurada para usar as credenciais fornecidas. Agora você pode usar a CLI do Microsoft Store para desenvolvedores (prévia) no pipeline de CI/CD.

  • Last updated on