Comandos (MSI/EXE)

Installation

Paso 1: Instalar .NET Windows Runtime

Si aún no lo ha hecho, instale la versión más reciente de .NET 8 Desktop Runtime. Este es un requisito para ejecutar la CLI para desarrolladores de Microsoft Store.

La manera más fácil de instalar es usar winget:

winget install Microsoft.DotNet.DesktopRuntime.8

Paso 2: Instalación de la CLI para desarrolladores de Microsoft Store en Windows

Puede descargar la CLI de Microsoft Store Developer desde el Microsoft Store. Como alternativa, puede usar winget:

winget install "Microsoft Store Developer CLI"

Paso 1: Instalar el Runtime de .NET para macOS

Si aún no lo ha hecho, instale la versión más reciente de .NET 8 Runtime. Este es un requisito para ejecutar la CLI para desarrolladores de Microsoft Store.

Paso 2: Instalación de la CLI para desarrolladores de Microsoft Store en macOS

Puede descargar el archivo .tar.gz de macOS para su arquitectura específica (x64 o Arm64) desde la página de versiones de la CLI para desarrolladores de Microsoft Store. Una vez descargado, extraiga el archivo comprimido y colóquelo en el PATH, como prefieras hacerlo, por ejemplo:

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, puede usar brew:

brew install microsoft/msstore-cli/msstore-cli

Paso 1: Instalar Runtime de .NET para Linux

Si aún no lo ha hecho, instale la versión más reciente de .NET 8 Runtime. Este es un requisito para ejecutar la CLI para desarrolladores de Microsoft Store.

Paso 2: Instalación de la CLI para desarrolladores de Microsoft Store en Linux

Puede descargar el archivo tar.gz de Linux para su arquitectura específica (x64 o Arm64) desde la página de lanzamientos del CLI de desarrolladores de Microsoft Store. Una vez descargado, extraiga el archivo comprimido y colóquelo en el PATH, como prefieras hacerlo, por ejemplo:

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, puede usar brew:

brew install microsoft/msstore-cli/msstore-cli

Comando Info

Imprima la configuración existente.

Usage

msstore info

Options

Opción Description
-v, --detallado Imprima la salida detallada.
-?, -h, --help: Ayuda Mostrar información de ayuda y uso.

Volver a configurar el comando

Vuelva a configurar la CLI para desarrolladores de Microsoft Store. Puede proporcionar un secreto de cliente o un certificado. Los certificados se pueden proporcionar a través de su huella digital o proporcionando una ruta de acceso de archivo (con o sin contraseña).

Usage

msstore reconfigure

Options

Opción Description
-t, --identificadorInquilino Especifique el identificador de inquilino que se debe usar.
-s, --sellerId (ID del vendedor) Especifique el identificador de vendedor que se debe usar.
-c, --clientId (ID del cliente) Especifique el identificador de cliente que se debe usar.
-cs, --clientSecret (secreto del cliente) Especifique el secreto de cliente que se debe usar.
-ct, --huellaDigitalCertificado Especifique la huella digital del certificado que se debe usar.
-cfp, --certificateFilePath Especifique la ruta de acceso del archivo de certificado que se debe usar.
-cp, --certificatePassword (contraseña del certificado) Especifique la contraseña del certificado que se debe usar.
--restablecimiento Restablezca solo las credenciales, sin empezar de nuevo.
-v, --detallado Imprima la salida detallada.
-?, -h, --help: Ayuda Mostrar información de ayuda y uso.

Comando de Configuración

Cambie la configuración de la CLI para desarrolladores de Microsoft Store.

Usage

msstore settings

Options

Opción Description
-t, --habilitarTelemetría Habilite (vacío/verdadero [true]) o deshabilite (falso [false]) la telemetría.
-v, --detallado Imprima la salida detallada.
-?, -h, --help: Ayuda Mostrar información de ayuda y uso.

Subcomando de SetPDN

Establezca la propiedad Nombre para mostrar del publicador.

Usage

msstore settings setpdn <publisherDisplayName>

Arguments

Argument Description
publisherDisplayName La propiedad "Nombre para mostrar del editor" que se configurará globalmente.

Options

Opción Description
-?, -h, --help: Ayuda Mostrar información de ayuda y uso.

Comando de envío

Subcomando Description
estado Obtiene el estado de un envío.
Obtener Obtiene los metadatos y la información del paquete de un envío específico.
getListingAssets Obtiene los activos de listado de una presentación específica.
updateMetadata Actualiza los metadatos de un envío específico.
actualizar Actualiza la información del paquete de un envío específico.
encuesta Sondea el estado de un envío.
publicar Publica un envío específico.

Envío: estado: uso

msstore submission status <productId>

Arguments

Argument Description
productId Identificador del Centro de asociados.

Options

Opción Description
-v, --detallado Imprima la salida detallada.
-?, -h, --help: Ayuda Mostrar información de ayuda y uso.

Envío - Obtener - Uso

msstore submission get <productId>

Arguments

Argument Description
productId Identificador del Centro de asociados.

Options

Opción Description
-l, --idioma Seleccione el idioma que desea recuperar. [valor predeterminado: en]
-v, --detallado Imprima la salida detallada.
-?, -h, --help: Ayuda Mostrar información de ayuda y uso.

Envío: GetListingAssets: uso

msstore submission getListingAssets <productId>

Arguments

Argument Description
productId Identificador del Centro de asociados.

Options

Opción Description
-l, --idioma Seleccione el idioma que desea recuperar. [valor predeterminado: en]
-v, --detallado Imprima la salida detallada.
-?, -h, --help: Ayuda Mostrar información de ayuda y uso.

Envío - ActualizarMetadatos - Uso

msstore submission updateMetadata <productId> <metadata>

Arguments

Argument Description
productId Identificador del Centro de asociados.
metadata Representación actualizada de metadatos JSON.

Options

Opción Description
-s, --skipInitialPolling (saltar el sondeo inicial) Omita el sondeo inicial antes de ejecutar la acción. [valor predeterminado: False]
-v, --detallado Imprima la salida detallada.
-?, -h, --help: Ayuda Mostrar información de ayuda y uso.

Envío: actualización: uso

msstore submission update <productId> <package>

Arguments

Argument Description
productId Identificador del Centro de asociados.
package Representación JSON actualizada del paquete de aplicación.

Options

Opción Description
-s, --skipInitialPolling (saltar el sondeo inicial) Omita el sondeo inicial antes de ejecutar la acción. [valor predeterminado: False]
-v, --detallado Imprima la salida detallada.
-?, -h, --help: Ayuda Mostrar información de ayuda y uso.

Sugerencia

Use submission get para recuperar el json del paquete actual antes de llamar a submission update. Esto garantiza que está trabajando con la estructura correcta y los valores actuales. Por ejemplo, en 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 obtener más contexto, consulta Publicar actualizaciones de la aplicación en Microsoft Store con Acciones de GitHub.

Envío - Encuesta - Uso

msstore submission poll <productId>

Arguments

Argument Description
productId Identificador del Centro de asociados.

Options

Opción Description
-v, --detallado Imprima la salida detallada.
-?, -h, --help: Ayuda Mostrar información de ayuda y uso.

Envío: publicación: uso

msstore submission publish <productId>

Arguments

Argument Description
productId Identificador del Centro de asociados.

Options

Opción Description
-v, --detallado Imprima la salida detallada.
-?, -h, --help: Ayuda Mostrar información de ayuda y uso.

Entornos de CI/CD

La CLI de Microsoft Store Developer (versión preliminar) admite la ejecución en entornos de CI/CD. Esto significa que puede usar la CLI para desarrolladores de Microsoft Store (versión preliminar) en las canalizaciones de CI/CD para, por ejemplo, publicar automáticamente las aplicaciones en el Microsoft Store.

El primer paso para lograr esto es instalar la CLI para desarrolladores de Microsoft Store (versión preliminar) en su entorno CI/CD. Puede encontrar instrucciones sobre cómo hacerlo aquí.

Después de instalar la CLI de Microsoft Store Developer (versión preliminar), debe configurar el entorno para poder ejecutar comandos. Para ello, ejecute el msstore reconfigure comando con los parámetros específicos que identifican la cuenta del Centro de partners (TenantId, SellerId, ClientId). También debe proporcionar un ClientSecret o un certificado.

Es muy importante ocultar estas credenciales, ya que estarán visibles en los registros de la canalización de CI/CD. Puede hacerlo mediante secretos. Cada sistema de canalización de CI/CD tiene nombres diferentes para estos secretos. Por ejemplo, Azure DevOps llamarlas Secret Variables, pero GitHub Action las llama Encrypted Secrets. Cree un secreto para cada uno de los parámetros (TenantId, SellerId, ClientId y ClientSecret o Certificate) y, a continuación, use el comando para configurar el reconfigure entorno.

Por ejemplo:

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

Acciones de GitHub

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

Una vez ejecutado este comando, la CLI de Microsoft Store developer (versión preliminar) se configurará para usar las credenciales proporcionadas. Ahora puede usar la interfaz de línea de comandos para desarrolladores de Microsoft Store (versión preliminar) en la canalización de CI/CD.

  • Last updated on