Comandos (MSI/EXE)

Installation

Passo 1: Instalar .NET Windows Runtime

Se ainda não o fez, instale a versão mais recente do .NET 8 Desktop Runtime. Isto é um requisito para correr a linha de comando do Microsoft Store Developer.

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

winget install Microsoft.DotNet.DesktopRuntime.8

Passo 2: Instale a CLI do Developer da Microsoft Store no Windows

Pode descarregar a CLI do Microsoft Store Developer a partir do Microsoft Store. Alternativamente, você pode usar winget:

winget install "Microsoft Store Developer CLI"

Passo 1: Instalar o Runtime do macOS .NET

Se ainda não o fez, instale a versão mais recente do Runtime .NET 8. Isto é um requisito para correr a linha de comando do Microsoft Store Developer.

Passo 2: Instalar a CLI de Desenvolvimento da Microsoft Store no macOS

Podes descarregar o macOS .tar.gz para a tua arquitetura específica (x64 ou Arm64) na página de lançamentos do Microsoft Store Developer Cli. Uma vez baixado, extraia o arquivo e coloque-o em seu PATH, como você quiser fazer isso, por exemplo:

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

Alternativamente, você pode usar brew:

brew install microsoft/msstore-cli/msstore-cli

Passo 1: Instalar o Runtime Linux .NET

Se ainda não o fez, instale a versão mais recente do Runtime .NET 8. Isto é um requisito para correr a linha de comando do Microsoft Store Developer.

Passo 2: Instalar a CLI de Desenvolvimento da Microsoft Store no Linux

Podes descarregar o Linux .tar.gz para a tua arquitetura específica (x64 ou Arm64) na página de lançamentos do Microsoft Store Developer Cli. Uma vez baixado, extraia o arquivo e coloque-o em seu PATH, como você quiser fazer isso, por exemplo:

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

Alternativamente, 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, --verborrágico Imprima a saída detalhada.
-?, -h, --ajuda Mostrar informações de ajuda e utilização.

Comando para Reconfigurar

Reconfigure a Interface de Linha de Comando do Desenvolvedor da Microsoft Store. Você pode fornecer um Segredo do Cliente ou um Certificado. Os certificados podem ser fornecidos através de sua impressão digital ou fornecendo um caminho de arquivo (com ou sem senha).

Usage

msstore reconfigure

Opções

Opção Description
-t, --idInquilino Especifique o ID do locatário que deve ser usado.
-s, --IdVendedor Especifique o ID do vendedor que deve ser usado.
-c, --identificadorCliente Especifique o ID do cliente que deve ser usado.
-cs, --segredo do cliente Especifique o segredo do cliente que deve ser usado.
-ct, --certificateImpressão digital Especifique a impressão digital (Thumbprint) do certificado que deve ser usada.
-cfp, --certificateFilePath Especifique o caminho do arquivo de certificado que deve ser usado.
-cp, --certificatePassword (palavra-passe do certificado) Especifique a senha do certificado que deve ser usada.
--reiniciar Apenas redefina as credenciais, sem começar de novo.
-v, --verborrágico Imprima a saída detalhada.
-?, -h, --ajuda Mostrar informações de ajuda e utilização.

Comando de Configurações

Alterar as definições da CLI da Microsoft Store para Desenvolvedores.

Usage

msstore settings

Opções

Opção Description
-t, --enableTelemetria Ative ou desative a telemetria (vazio/verdadeiro/falso).
-v, --verborrágico Imprima a saída detalhada.
-?, -h, --ajuda Mostrar informações de ajuda e utilização.

SetPDN Sub-Comando

Defina a propriedade Publisher Display Name.

Usage

msstore settings setpdn <publisherDisplayName>

Arguments

Argument Description
publisherDisplayName A propriedade Publisher Display Name que será definida globalmente.

Opções

Opção Description
-?, -h, --ajuda Mostrar informações de ajuda e utilização.

Comando de envio

Sub-comando Description
Situação 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 listados de uma submissão específica.
updateMetadados Atualiza os metadados de um envio específico.
atualizar Atualiza as informações do pacote de um envio específico.
sondagem Sonda o status de um envio.
publicar Publica uma submissão específica.

Submissão - Estado - Utilização

msstore submission status <productId>

Arguments

Argument Description
productId O Identificador do Partner Center.

Opções

Opção Description
-v, --verborrágico Imprima a saída detalhada.
-?, -h, --ajuda Mostrar informações de ajuda e utilização.

Submissão - Obter - Utilização

msstore submission get <productId>

Arguments

Argument Description
productId O Identificador do Partner Center.

Opções

Opção Description
-l, --língua Selecione o idioma que deseja recuperar. [padrão: en]
-v, --verborrágico Imprima a saída detalhada.
-?, -h, --ajuda Mostrar informações de ajuda e utilização.

Submissão - GetListingAssets - Uso

msstore submission getListingAssets <productId>

Arguments

Argument Description
productId O Identificador do Partner Center.

Opções

Opção Description
-l, --língua Selecione o idioma que deseja recuperar. [padrão: en]
-v, --verborrágico Imprima a saída detalhada.
-?, -h, --ajuda Mostrar informações de ajuda e utilização.

Submissão - Atualizar Metadados - Uso

msstore submission updateMetadata <productId> <metadata>

Arguments

Argument Description
productId O Identificador do Partner Center.
metadata A representação de metadados JSON atualizada.

Opções

Opção Description
-s, --ignorarPollingInicial Ignore a sondagem inicial antes de executar a ação. [padrão: False]
-v, --verborrágico Imprima a saída detalhada.
-?, -h, --ajuda Mostrar informações de ajuda e utilização.

Submissão - Atualização - Utilização

msstore submission update <productId> <package>

Arguments

Argument Description
productId O Identificador do Partner Center.
package A representação JSON atualizada do pacote do aplicativo.

Opções

Opção Description
-s, --ignorarPollingInicial Ignore a sondagem inicial antes de executar a ação. [padrão: False]
-v, --verborrágico Imprima a saída detalhada.
-?, -h, --ajuda Mostrar informações de ajuda e utilização.

Sugestão

Use submission get para recuperar o JSON do pacote atual antes de chamar submission update. Isto garante que está a trabalhar 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 mais contexto, veja Publicar atualizações de aplicações para Microsoft Store com GitHub Actions.

Submissão - Sondagem - Utilização

msstore submission poll <productId>

Arguments

Argument Description
productId O Identificador do Partner Center.

Opções

Opção Description
-v, --verborrágico Imprima a saída detalhada.
-?, -h, --ajuda Mostrar informações de ajuda e utilização.

Submissão - Publicar - Utilização

msstore submission publish <productId>

Arguments

Argument Description
productId O Identificador do Partner Center.

Opções

Opção Description
-v, --verborrágico Imprima a saída detalhada.
-?, -h, --ajuda Mostrar informações de ajuda e utilização.

Ambientes CI/CD

A CLI do Microsoft Store Developer (versão prévia) é compatível com a execução em ambientes CI/CD. Isto significa que pode usar a Microsoft Store Developer CLI (pré-visualização) nos seus pipelines CI/CD para, por exemplo, publicar automaticamente as suas aplicações na Microsoft Store.

O primeiro passo para conseguir isto é instalar a CLI do Microsoft Store Developer (pré-visualização) no seu ambiente CI/CD. Você pode encontrar instruções sobre como fazer isso aqui.

Depois de instalar a Microsoft Store Developer CLI (pré-visualização), tens de configurar o teu ambiente para conseguir 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 serão visíveis nos logs do seu pipeline de CI/CD. Você pode fazer isso usando segredos. Cada sistema de pipeline CI/CD pode usar nomes diferentes para esses segredos. Por exemplo, o Azure DevOps chama-lhes Variáveis Secretas, enquanto o GitHub Actions chama-lhes Segredos Encriptados. Crie um segredo para cada um dos parâmetros (TenantId, SellerId, ClientId e ClientSecret ou um Certificado) e, em seguida, use o comando para configurar seu reconfigure 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 }}

Uma vez executado este comando, a CLI do Microsoft Store Developer (pré-visualização) será configurada para usar as credenciais fornecidas. Agora pode usar o Microsoft Store Developer CLI (pré-visualização) no seu pipeline de CI/CD.

  • Last updated on