Instalación
Paso 1: Instalar .NET Windows Runtime
Si aún no lo ha hecho, instale la versión más reciente de .NET 9 Desktop Runtime. Este es un requisito para ejecutar la CLI para desarrolladores de Microsoft Store.
La manera más fácil de instalarla es mediante winget:
winget install Microsoft.DotNet.DesktopRuntime.9
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 .NET macOS Runtime
Si aún no lo ha hecho, instale la versión más reciente de la .NET 9 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 .tar.gz de macOS para tu arquitectura específica (x64 o Arm64) desde la página de lanzamientos de la CLI de desarrollador de Microsoft Store. Una vez descargado, extraiga el archivo y colóquelo en la PATH, como quieras, 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: Instale el Runtime de .NET para Linux
Si aún no lo ha hecho, instale la versión más reciente de la .NET 9 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 .tar.gz de Linux para su arquitectura específica (x64 o Arm64) desde la página de lanzamientos de la CLI de Desarrollador del Microsoft Store. Una vez descargado, extraiga el archivo y colóquelo en la PATH, como quieras, 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 de información
Imprima la configuración existente.
Usage
msstore info
Options
| Opción |
Descripción |
| -v, --detallado |
Imprima la salida detallada. |
| -?, -h, --help: Ayuda |
Mostrar información de ayuda y uso. |
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 |
Descripción |
| -t, --identificadorInquilino |
Especifique el identificador de inquilino que se debe usar. |
| -s, --sellerId |
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, --certificadoHuella digital |
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. |
| --reiniciar |
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 configuraciones
Cambie la configuración de la CLI para desarrolladores de Microsoft Store.
Usage
msstore settings
Options
| Opción |
Descripción |
| -t, --habilitarTelemetry |
Habilite (vacío/verdadero) o deshabilite (falso) 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 Publisher nombre para mostrar que usa el comando init.
Usage
msstore settings setpdn <publisherDisplayName>
Argumentos
| Argumento |
Descripción |
publisherDisplayName |
La propiedad Nombre para mostrar del editor que se establecerá globalmente. |
Options
| Opción |
Descripción |
| -?, -h, --help: Ayuda |
Mostrar información de ayuda y uso. |
Comando de aplicaciones
| Subcomando |
Descripción |
|
lista |
Enumera todas las aplicaciones de la cuenta. |
|
Obtener |
Obtiene los detalles de una aplicación específica. |
Aplicaciones: lista: uso
msstore apps list
Options
| Opción |
Descripción |
| -v, --detallado |
Imprima la salida detallada. |
| -?, -h, --help: Ayuda |
Mostrar información de ayuda y uso. |
Aplicaciones - Obtener - Uso
msstore apps get <productId>
Argumentos
| Argumento |
Descripción |
productId |
ID de producto de la Tienda. |
Options
| Opción |
Descripción |
| -v, --detallado |
Imprima la salida detallada. |
| -?, -h, --help: Ayuda |
Mostrar información de ayuda y uso. |
Comando de envío
| Subcomando |
Descripción |
|
estado |
Obtiene el estado de un envío. |
|
Obtener |
Obtiene los metadatos y la información del paquete de un envío específico. |
|
obtenerActivosDeListado |
Obtiene los activos de listado de un envío específico. |
|
actualizarMetadatos |
Actualiza los metadatos de un envío específico. |
|
actualizar |
Actualiza el paquete de un envío específico. |
|
encuesta |
Sondea el estado de un envío. |
|
publicar |
Publica una presentación específica. |
|
eliminación |
Elimina un envío específico. |
Envío: estado: uso
msstore submission status <productId>
Argumentos
| Argumento |
Descripción |
productId |
ID de producto de la Tienda. |
Options
| Opción |
Descripción |
| -v, --detallado |
Imprima la salida detallada. |
| -?, -h, --help: Ayuda |
Mostrar información de ayuda y uso. |
Envío - Obtener - Uso
msstore submission get <productId>
Argumentos
| Argumento |
Descripción |
productId |
ID de producto de la Tienda. |
Options
| Opción |
Descripción |
| -v, --detallado |
Imprima la salida detallada. |
| -?, -h, --help: Ayuda |
Mostrar información de ayuda y uso. |
Envío: GetListingAssets: uso
msstore submission getListingAssets <productId>
Argumentos
| Argumento |
Descripción |
productId |
ID de producto de la Tienda. |
Options
| Opción |
Descripción |
| -v, --detallado |
Imprima la salida detallada. |
| -?, -h, --help: Ayuda |
Mostrar información de ayuda y uso. |
msstore submission updateMetadata <productId> <metadata>
Argumentos
| Argumento |
Descripción |
productId |
ID de producto de la Tienda. |
metadata |
Representación actualizada de metadatos JSON. |
Options
| Opción |
Descripción |
| -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>
Argumentos
| Argumento |
Descripción |
productId |
ID de producto de la Tienda. |
package |
Representación JSON actualizada del paquete de aplicación. |
Options
| Opción |
Descripción |
| -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
# 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>
Argumentos
| Argumento |
Descripción |
productId |
ID de producto de la Tienda. |
Options
| Opción |
Descripción |
| -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>
Argumentos
| Argumento |
Descripción |
productId |
ID de producto de la Tienda. |
Options
| Opción |
Descripción |
| -v, --detallado |
Imprima la salida detallada. |
| -?, -h, --help: Ayuda |
Mostrar información de ayuda y uso. |
Envío: eliminación: uso
msstore submission delete <productId>
Argumentos
| Argumento |
Descripción |
productId |
ID de producto de la Tienda. |
Options
| Opción |
Descripción |
| --no-confirmar |
No solicitar confirmación. [valor predeterminado: False] |
| -v, --detallado |
Imprima la salida detallada. |
| -?, -h, --help: Ayuda |
Mostrar información de ayuda y uso. |
Comandos de vuelos
| Subcomando |
Descripción |
|
lista |
Recupera todos los vuelos de la aplicación especificada. |
|
Obtener |
Recupera un vuelo para la aplicación y el vuelo especificados. |
|
eliminación |
Elimina un vuelo para la aplicación y el vuelo especificados. |
|
create |
Crea un vuelo para la aplicación y el vuelo especificados. |
|
Sumisión |
Ejecutar tareas relacionadas con presentaciones de vuelos. |
Vuelos: uso de comandos de lista
msstore flights list <productId>
Vuelos: argumentos de comando de lista
| Argumento |
Descripción |
productId |
Identificador del producto. |
Vuelos- Ayuda del comando List
msstore flights list --help
Vuelos - Consultar el uso de comandos
msstore flights get <productId> <flightId>
Vuelos: obtener argumentos de comando
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Vuelos - Obtener ayuda sobre comandos
msstore flights get --help
Vuelos: eliminación del uso de comandos
msstore flights delete <productId> <flightId>
Vuelos: eliminar argumentos de comando
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Vuelos: Ayuda para eliminar comandos
msstore flights delete --help
Vuelos: crear uso de comandos
msstore flights create <productId> <friendlyName> --group-ids <group-ids>
Vuelos: crear argumentos de comando
| Argumento |
Descripción |
productId |
Identificador del producto. |
friendlyName |
Nombre amigable del vuelo. |
Vuelos: crear opciones de comando
| Opción |
Descripción |
| -g, --id de grupos |
Identificadores de grupo para asociar al vuelo. |
| -r, --rank-más-alto-que |
Identificador de vuelo que se va a clasificar más alto que. |
Vuelos: Ayuda para crear comandos
msstore flights create --help
Vuelos : comando de envío
| Subcomando |
Descripción |
|
Obtener |
Recupera la presentación del paquete de vuelo existente, ya sea el borrador actual o el último publicado. |
|
eliminación |
Elimina la presentación del paquete de vuelo pendiente de la tienda. |
|
actualizar |
Actualiza el borrador de vuelo existente con el JSON proporcionado. |
|
publicar |
Inicia el proceso de envío de vuelos para el borrador existente. |
|
encuesta |
Consulta hasta que se publique o falle el envío del vuelo existente. |
|
estado |
Recupera el estado actual de la entrega de vuelo de la tienda. |
|
lanzamiento |
Ejecutar operaciones relacionadas con la implementación de paquetes piloto. |
Vuelos: Uso del comando para obtener el envío
msstore flights submission get <productId> <flightId>
Vuelos - Obtener argumentos de comando de presentación
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Vuelos - Ayuda para el comando de envío Get
msstore flights submission get --help
Vuelos: uso del comando Delete de envío
msstore flights submission delete <productId> <flightId>
Comando de eliminación de argumentos de presentación de vuelos
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Vuelos: ayuda del comando Delete de envío
msstore flights submission delete --help
Vuelos: uso del comando de actualización de envío
msstore flights submission update <productId> <flightId> <product>
Vuelos: argumentos de comando de actualización de envío
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
product |
Representación actualizada del producto JSON. |
Comandos de actualización de presentación - Opciones de vuelos
| Opción |
Descripción |
| -s, --skipInitialPolling (saltar el sondeo inicial) |
Omita el sondeo inicial antes de ejecutar la acción. [valor predeterminado: False] |
Vuelos: Ayuda del comando de actualización de envío
msstore flights submission update --help
Vuelos - Uso del comando de publicación de presentaciones
msstore flights submission publish <productId> <flightId>
Vuelos: argumentos de comando publicar envío
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Vuelos: ayuda del comando de publicación de presentaciones
msstore flights submission publish --help
Vuelos: uso del comando de encuesta de envío
msstore flights submission poll <productId> <flightId>
Vuelos: argumentos de comando para el envío de encuestas
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Vuelos: ayuda del comando de sondeo de envío
msstore flights submission poll --help
Vuelos: uso de comandos de estado de envío
msstore flights submission status <productId> <flightId>
Vuelos: argumentos de comando de estado de envío
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Vuelos: ayuda del comando Estatus de envío
msstore flights submission status --help
Vuelos - Envío - Comando de Despliegue
| Subcomando |
Descripción |
|
Obtener |
Recupera el estado de lanzamiento piloto de un envío. |
|
actualizar |
Actualice el porcentaje de lanzamiento piloto de un envío. |
|
parar |
Detiene el lanzamiento piloto de un envío. |
|
finalizar |
Finaliza el lanzamiento piloto de un envío. |
Vuelos : envío: uso de comandos de obtención de lanzamiento
msstore flights submission rollout get <productId> <flightId>
Vuelos - Envío - Despliegue de argumentos del comando Get
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Vuelos - Envío - Opciones de Comando para la Obtención del Lanzamiento
| Opción |
Descripción |
| -s, --idDeEnvío |
Identificador de envío. |
Vuelos - Despliegue - Obtener ayuda del comando
msstore flights submission rollout get --help
Vuelos - Envío - Uso del comando de actualización de despliegue
msstore flights submission rollout update <productId> <flightId> <percentage>
Vuelos: envío: argumentos de comando de actualización de lanzamiento
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
percentage |
Porcentaje de usuarios que recibirán el lanzamiento de envío. |
Vuelos - Envío - Opciones de comando de actualización de lanzamiento
| Opción |
Descripción |
| -s, --idDeEnvío |
Identificador de envío. |
Vuelos - Envío - Ayuda del comando de actualización de despliegue
msstore flights submission rollout update --help
Vuelos - Presentación - Uso de Comandos para Detener Despliegue
msstore flights submission rollout halt <productId> <flightId>
Despliegues - Entrega - Argumentos del comando para detener el despliegue
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Vuelos - Envío - Opciones de comando de detención de lanzamiento
| Opción |
Descripción |
| -s, --idDeEnvío |
Identificador de envío. |
Vuelos - Envío - Ayuda de comando Detener despliegue
msstore flights submission rollout halt --help
Vuelos : envío: uso final de comandos de lanzamiento
msstore flights submission rollout finalize <productId> <flightId>
Vuelos - Envío - Argumentos del Comando de Finalización del Despliegue
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Vuelos - Implementación - Opciones de comandos para finalizar el lanzamiento
| Opción |
Descripción |
| -s, --idDeEnvío |
Identificador de envío. |
Vuelos- Envío: Ayuda del comando Rollout Finalize
msstore flights submission rollout finalize --help
Comando de inicialización
El comando init le ayuda a configurar la aplicación para publicar en el Microsoft Store. Actualmente admite los siguientes tipos de aplicación:
- WinUI
- .NET MAUI
- Flutter
- Electrón
- React Native para escritorio
- PWA
- Plataforma Universal de Windows (UWP)
Ejemplos de uso
SDK de Aplicaciones para Windows/WinUI
msstore init "C:\path\to\winui3_app"
Plataforma Universal de Windows (UWP)
msstore init "C:\path\to\uwp_app"
.NET MAUI
msstore init "C:\path\to\maui_app"
Flutter
msstore init "C:\path\to\flutter_app"
Electrón
msstore init "C:\path\to\electron_app"
React Native para escritorio
msstore init "C:\path\to\react_native_app"
Nota:
Para Electron, así como para proyectos de escritorio con React Native, se admiten tanto Npm como Yarn. La presencia del archivo de bloqueo (Yarn) se usará para determinar qué administrador de paquetes utilizar, así que asegúrese de ingresar el archivo de bloqueo yarn.lock en el sistema de control de código fuente.
PWA
msstore init https://contoso.com --output .
Argumentos
| Argumento |
Descripción |
pathOrUrl |
Ruta de acceso del directorio raíz donde está el archivo del proyecto o una URL pública que apunta a una PWA. |
Options
| Opción |
Descripción |
| -n, --nombreMostradoEditor |
El Publisher nombre para mostrar usado para configurar la aplicación. Si se proporciona, evita una llamada adicional a las API. |
| --paquete |
Si es compatible con el tipo de aplicación, empaqueta automáticamente el proyecto. |
| --publicar |
Si es compatible con el tipo de aplicación, publica automáticamente el proyecto. Implica "--package true" |
| -f, --ID de vuelo |
Especifica el id. de vuelo donde se publicará el paquete. |
| -prp, --porcentajeImplementaciónPaquete |
Especifica el porcentaje de lanzamiento del paquete. El valor debe estar entre 0 y 100. |
| -a, --arco |
Arquitecturas para las que se va a compilar. Si no se proporciona, se usará la arquitectura predeterminada para el sistema operativo actual y el tipo de proyecto. Valores permitidos: "x86", "x64", "arm64". Solo se utiliza en conjunto con "--package true". |
| -o, --salida |
Directorio de salida donde se almacenará la aplicación empaquetada. Si no se proporciona, se usará el directorio predeterminado para cada tipo de aplicación diferente. |
| -ver, --version (muestra la versión) |
Versión que se usa al compilar la aplicación. Si no se proporciona, se usará la versión del archivo del proyecto. |
Comando de paquetes
Le ayuda a empaquetar la aplicación de Microsoft Store como MSIX.
Ejemplos de uso
SDK de Aplicaciones para Windows/WinUI
msstore package "C:\path\to\winui3_app"
WinUI
msstore package "C:\path\to\uwp_app"
.NET MAUI
msstore package "C:\path\to\maui_app"
Flutter
msstore package "C:\path\to\flutter_app"
Electrón
msstore package "C:\path\to\electron_app"
React Native para escritorio
msstore package "C:\path\to\react_native_app"
PWA
msstore package "C:\path\to\pwa_app"
Argumentos
| Opción |
Descripción |
pathOrUrl |
Ruta de acceso del directorio raíz donde está el archivo del proyecto o una URL pública que apunta a una PWA. |
Options
| Opción |
Descripción |
| -o, --salida |
Directorio de salida donde se almacenará la aplicación empaquetada. Si no se proporciona, se usará el directorio predeterminado para cada tipo de aplicación diferente. |
| -a, --arco |
Arquitecturas para las que se va a compilar. Si no se proporciona, se usará la arquitectura predeterminada para el sistema operativo actual y el tipo de proyecto. Valores permitidos: "x86", "x64", "arm64". |
| -ver, --version (muestra la versión) |
Versión que se usa al compilar la aplicación. Si no se proporciona, se usará la versión del archivo del proyecto. |
Comando de publicación
Publica la aplicación en el Microsoft Store.
Ejemplos de uso
SDK de Aplicaciones para Windows/WinUI
msstore publish "C:\path\to\winui3_app"
WinUI
msstore publish "C:\path\to\uwp_app"
.NET MAUI
msstore publish "C:\path\to\maui_app"
Flutter
msstore publish "C:\path\to\flutter_app"
Electrón
msstore publish "C:\path\to\electron_app"
React Native para escritorio
msstore publish "C:\path\to\react_native_app"
PWA
msstore publish "C:\path\to\pwa_app"
Argumentos
| Opción |
Descripción |
pathOrUrl |
Ruta de acceso del directorio raíz donde está el archivo del proyecto o una URL pública que apunta a una PWA. |
Options
| Opción |
Descripción |
| -i, --archivoEntrada |
Ruta de acceso al archivo '.msix' o '.msixupload' que se usará para el comando de publicación. Si no se proporciona, la CLI intentará encontrar el mejor candidato en función del argumento "pathOrUrl". |
| -id, --appId |
Especifica el identificador de la aplicación. Solo es necesario si el proyecto no se ha inicializado antes con el comando "init". |
| -nc, --noCommit |
Deshabilita la confirmación del envío y la mantiene en estado de borrador. |
| -f, --ID de vuelo |
Especifica el id. de vuelo donde se publicará el paquete. |
| -prp, --porcentajeImplementaciónPaquete |
Especifica el porcentaje de lanzamiento del paquete. El valor debe estar entre 0 y 100. |
Comando de vuelo
| Subcomando |
Descripción |
|
lista |
Recupera todos los vuelos de la aplicación especificada. |
|
Obtener |
Recupera un vuelo para la aplicación y el vuelo especificados. |
|
eliminación |
Elimina un vuelo para la aplicación y el vuelo especificados. |
|
create |
Crea un vuelo para la aplicación y el vuelo especificados. |
|
Sumisión |
Ejecutar tareas relacionadas con presentaciones de vuelos. |
Vuelos - Lista - Uso
msstore flights list <productId>
Argumentos
| Argumento |
Descripción |
productId |
Identificador del producto. |
Options
| Opción |
Descripción |
| -v, --detallado |
Imprima la salida detallada. |
| -?, -h, --help: Ayuda |
Mostrar información de ayuda y uso. |
Vuelos - Obtener - Uso
msstore flights get <productId> <flightId>
Argumentos
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Options
| Opción |
Descripción |
| -v, --detallado |
Imprima la salida detallada. |
| -?, -h, --help: Ayuda |
Mostrar información de ayuda y uso. |
Vuelos - Eliminar - Uso
msstore flights delete <productId> <flightId>
Argumentos
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Options
| Opción |
Descripción |
| -v, --detallado |
Imprima la salida detallada. |
| -?, -h, --help: Ayuda |
Mostrar información de ayuda y uso. |
Vuelos - Crear - Uso
msstore flights create <productId> <friendlyName> --group-ids <group-ids>
Argumentos
| Argumento |
Descripción |
productId |
Identificador del producto. |
friendlyName |
Nombre amigable del vuelo. |
Options
| Opción |
Descripción |
| -g, --id de grupos |
Identificadores de grupo para asociar al vuelo. |
| -r, --rank-más-alto-que |
Identificador de vuelo que se va a clasificar más alto que. |
| -v, --detallado |
Imprima la salida detallada. |
| -?, -h, --help: Ayuda |
Mostrar información de ayuda y uso. |
Vuelos - Presentación
| Subcomando |
Descripción |
|
Obtener |
Recupera la presentación del paquete de vuelo existente, ya sea el borrador actual o el último publicado. |
|
eliminación |
Elimina la presentación del paquete de vuelo pendiente de la tienda. |
|
actualizar |
Actualiza el borrador de vuelo existente con el JSON proporcionado. |
|
publicar |
Inicia el proceso de envío de vuelos para el borrador existente. |
|
encuesta |
Consulta hasta que se publique o falle el envío del vuelo existente. |
|
estado |
Recupera el estado actual de la entrega de vuelo de la tienda. |
|
lanzamiento |
Ejecutar operaciones relacionadas con la implementación de paquetes piloto. |
Vuelos - Envío de datos - Consulta - Uso
msstore flights submission get <productId> <flightId>
Argumentos
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Options
| Opción |
Descripción |
| -v, --detallado |
Imprima la salida detallada. |
| -?, -h, --help: Ayuda |
Mostrar información de ayuda y uso. |
Vuelos - Envío - Eliminar - Uso
msstore flights submission delete <productId> <flightId>
Argumentos
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Options
| Opción |
Descripción |
| --no-confirmar |
No solicitar confirmación. |
| -v, --detallado |
Imprima la salida detallada. |
| -?, -h, --help: Ayuda |
Mostrar información de ayuda y uso. |
Vuelos - Envío - Actualización - Uso
msstore flights submission update <productId> <flightId> <product>
Argumentos
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
product |
Representación actualizada del producto JSON. |
Options
| Opción |
Descripción |
| -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. |
Vuelos - Envío - Publicación - Uso
msstore flights publish <productId> <flightId>
Argumentos
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Options
| Opción |
Descripción |
| -v, --detallado |
Imprima la salida detallada. |
| -?, -h, --help: Ayuda |
Mostrar información de ayuda y uso. |
Vuelos - Envío - Sondeo - Uso
msstore flights poll <productId> <flightId>
Argumentos
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Options
| Opción |
Descripción |
| -v, --detallado |
Imprima la salida detallada. |
| -?, -h, --help: Ayuda |
Mostrar información de ayuda y uso. |
Vuelos - Envío - Estado - Uso
msstore flights status <productId> <flightId>
Argumentos
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Options
| Opción |
Descripción |
| -v, --detallado |
Imprima la salida detallada. |
| -?, -h, --help: Ayuda |
Mostrar información de ayuda y uso. |
Vuelos - Presentación - Lanzamiento
| Subcomando |
Descripción |
|
Obtener |
Recupera el estado de lanzamiento piloto de un envío. |
|
actualizar |
Actualice el porcentaje de lanzamiento piloto de un envío. |
|
parar |
Detiene el lanzamiento piloto de un envío. |
|
finalizar |
Finaliza el lanzamiento piloto de un envío. |
Vuelos - Envío - Lanzamiento - Obtener - Uso
msstore flights submission rollout get <productId> <flightId>
Argumentos
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Options
| Opción |
Descripción |
| -s, --idDeEnvío |
Identificador de envío. |
| -v, --detallado |
Imprima la salida detallada. |
| -?, -h, --help: Ayuda |
Mostrar información de ayuda y uso. |
Vuelos - Envío - Lanzamiento - Actualización - Uso
msstore flights submission rollout update <productId> <flightId> <percentage>
Argumentos
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
percentage |
Porcentaje de usuarios que recibirán el lanzamiento de envío. |
Options
| Opción |
Descripción |
| -s, --idDeEnvío |
Identificador de envío. |
| -v, --detallado |
Imprima la salida detallada. |
| -?, -h, --help: Ayuda |
Mostrar información de ayuda y uso. |
Vuelos - Presentación - Despliegue - Paralización - Uso
msstore flights submission rollout halt <productId> <flightId>
Argumentos
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Options
| Opción |
Descripción |
| -s, --idDeEnvío |
Identificador de envío. |
| -v, --detallado |
Imprima la salida detallada. |
| -?, -h, --help: Ayuda |
Mostrar información de ayuda y uso. |
Vuelos - Envío - Lanzamiento - Finalizar - Utilización
msstore flights submission rollout finalize <productId> <flightId>
Argumentos
| Argumento |
Descripción |
productId |
Identificador del producto. |
flightId |
Id. de vuelo. |
Options
| Opción |
Descripción |
| -s, --idDeEnvío |
Identificador de envío. |
| -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 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 hacer esto 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 puedes usar la CLI para desarrolladores de Microsoft Store (en versión preliminar) en la canalización de CI/CD.
