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: Instalar la CLI para desarrolladores de Microsoft Store en Windows

Puedes descargar la CLI para desarrolladores de Microsoft Store desde Microsoft Store. Como alternativa, puede usar winget:

winget install "Microsoft Store Developer CLI"

Paso 1: Instalación del entorno de ejecución de .NET 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: Instalar la CLI para desarrolladores de Microsoft Store en macOS

Puedes descargar el .tar.gz de macOS para tu 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: Instalación de .NET Linux Runtime

Si aún no lo ha hecho, instale la última versión del runtime .NET 8. Este es un requisito para ejecutar la CLI para desarrolladores de Microsoft Store.

Paso 2: Instalar la CLI para desarrolladores de Microsoft Store en Linux

Puedes descargar la .tar.gz de Linux para tu 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 y colóquelo en el PATH, de la manera que prefiera, 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	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, --tenantId	Especifique el identificador de inquilino que se debe usar.
-s, --sellerId	Especifique el identificador de vendedor que se debe usar.
-c, --clientId	Especifique el identificador de cliente que se debe usar.
-cs, --clientSecret	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, --verbose (modo detallado)	Imprima la salida detallada.
-?, -h, --help	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, --verbose (modo detallado)	Imprima la salida detallada.
-?, -h, --help	Mostrar información de ayuda y uso.

SetPDN Sub-Command

Establezca la propiedad Nombre para mostrar del publicador.

Usage

msstore settings setpdn <publisherDisplayName>

Arguments

Argument	Description
publisherDisplayName	La propiedad nombre de visualización del editor que se establecerá globalmente.

Options

Opción	Description
-?, -h, --help	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, --verbose (modo detallado)	Imprima la salida detallada.
-?, -h, --help	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, --verbose (modo detallado)	Imprima la salida detallada.
-?, -h, --help	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, --language	Seleccione el idioma que desea recuperar. [valor predeterminado: en]
-v, --verbose (modo detallado)	Imprima la salida detallada.
-?, -h, --help	Mostrar información de ayuda y uso.

Envío - ActualizarMetadatos - Uso

msstore submission updateMetadata <productId> <metadata>

Arguments

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

Options

Opción	Description
-s, --skipInitialPolling	Omita el sondeo inicial antes de ejecutar la acción. [valor predeterminado: False]
-v, --verbose (modo detallado)	Imprima la salida detallada.
-?, -h, --help	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 Partners.
package	Representación JSON actualizada del paquete de aplicación.

Options

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

Envío - Encuesta - Uso

msstore submission poll <productId>

Arguments

Argument	Description
productId	Identificador del centro de partners.

Options

Opción	Description
-v, --verbose (modo detallado)	Imprima la salida detallada.
-?, -h, --help	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, --verbose (modo detallado)	Imprima la salida detallada.
-?, -h, --help	Mostrar información de ayuda y uso.

Entornos de CI/CD

La CLI para desarrolladores de Microsoft Store (versión preliminar) admite la ejecución en entornos de CI/CD. Esto significa que puedes 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 Microsoft Store.

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

Después de instalar la CLI para desarrolladores de Microsoft Store (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 los llama Variables secretas, pero La acción de GitHub los llama Secretos cifrados. 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

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

Una vez ejecutado este comando, la CLI para desarrolladores de Microsoft Store (versión preliminar) se configurará para usar las credenciales proporcionadas. Ahora puede utilizar el CLI para desarrolladores de Microsoft Store (versión preliminar) en su flujo de trabajo CI/CD.