Команды (MSI/EXE)

Installation

Шаг 1. Установка .NET среда выполнения Windows

Если это еще не сделано, установите последнюю версию .NET 8 Desktop Runtime. Это требование для запуска интерфейса командной строки разработчика Microsoft Store.

Самый простой способ установить его — использовать winget:

winget install Microsoft.DotNet.DesktopRuntime.8

Шаг 2. Установка интерфейса командной строки разработчика Microsoft Store на Windows

Вы можете скачать интерфейс командной строки разработчика Microsoft Store из Microsoft Store. Кроме того, можно использовать winget:

winget install "Microsoft Store Developer CLI"

Шаг 1. Установка среды выполнения macOS .NET

Если это еще не сделано, установите последнюю версию .NET 8 Runtime. Это требование для запуска интерфейса командной строки разработчика Microsoft Store.

Шаг 2. Установка интерфейса командной строки разработчика Microsoft Store в macOS

Вы можете загрузить macOS .tar.gz для вашей конкретной архитектуры (x64 или Arm64) со страницы выпусков CLI разработчика Microsoft Store. После скачивания извлеките архив и добавьте его в переменную PATH, как вам удобнее, например:

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

Кроме того, можно использовать brew:

brew install microsoft/msstore-cli/msstore-cli

Шаг 1. Установка среды выполнения Linux .NET

Если это еще не сделано, установите последнюю версию .NET 8 Runtime. Это требование для запуска интерфейса командной строки разработчика Microsoft Store.

Шаг 2. Установка интерфейса командной строки разработчика Microsoft Store в Linux

Вы можете скачать Linux .tar.gz для конкретной архитектуры (x64 или Arm64) со страницы выпусков Microsoft Store Developer CLI. После скачивания извлеките архив и добавьте его в переменную PATH, как вам удобнее, например:

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

Кроме того, можно использовать brew:

brew install microsoft/msstore-cli/msstore-cli

Команда информации

Распечатать текущую конфигурацию.

Usage

msstore info

Options

Вариант Description
-v, --подробный вывод Печать подробных выходных данных.
-?, -h, --help (помощь) Показать справку и информацию об использовании.

Команда перенастройки

Повторно настройте интерфейс командной строки разработчика Microsoft Store. Вы можете указать секрет клиента или сертификат. Сертификаты можно предоставить либо с помощью отпечатка, либо путем предоставления пути к файлу (с паролем или без нее).

Usage

msstore reconfigure

Options

Вариант Description
-t, --идентификаторАрендатора Укажите идентификатор клиента, который следует использовать.
-s, --sellerId (идентификатор продавца) Укажите идентификатор продавца, который следует использовать.
-c, --идентификаторКлиента Укажите идентификатор клиента, который следует использовать.
-cs, --clientSecret (секрет клиента) Укажите секрет клиента, который следует использовать.
-ct, --certificateThumbprint (отпечаток сертификата) Укажите отпечаток сертификата, который следует использовать.
-cfp, --certificateFilePath (путь к файлу сертификата) Укажите путь к файлу сертификата, который следует использовать.
-cp, --certificatePassword (пароль сертификата) Укажите пароль сертификата, который следует использовать.
--сброс Только сбросьте учетные данные, не начиная заново.
-v, --подробный вывод Печать подробных выходных данных.
-?, -h, --help (помощь) Показать справку и информацию об использовании.

Команда "Параметры"

Изменение параметров интерфейса командной строки разработчика Microsoft Store.

Usage

msstore settings

Options

Вариант Description
-t, --enableTelemetry (включить телеметрию) Включите (пустое значение или «true») или отключите («false») телеметрию.
-v, --подробный вывод Печать подробных выходных данных.
-?, -h, --help (помощь) Показать справку и информацию об использовании.

SetPDN подкоманда

Задайте свойство "Display Name" издателя.

Usage

msstore settings setpdn <publisherDisplayName>

Arguments

Аргумент Description
publisherDisplayName Свойство отображаемого имени Publisher, которое будет задано глобально.

Options

Вариант Description
-?, -h, --help (помощь) Показать справку и информацию об использовании.

Команда отправки

Подкоманда Description
статус Возвращает статус заявки.
получить Возвращает метаданные и сведения о пакете определенной отправки.
getListingAssets Возвращает активы списка конкретной заявки.
updateMetadata Обновляет метаданные определенной отправки.
обновлять Обновляет сведения о пакете определенной отправки.
опрос Опрашивает состояние представленной заявки.
издавать Публикует определенную заявку.

Отправка — состояние — использование

msstore submission status <productId>

Arguments

Аргумент Description
productId Идентификатор центра партнеров.

Options

Вариант Description
-v, --подробный вывод Печать подробных выходных данных.
-?, -h, --help (помощь) Показать справку и информацию об использовании.

Отправка — получение — использование

msstore submission get <productId>

Arguments

Аргумент Description
productId Идентификатор центра партнеров.

Options

Вариант Description
-l, --язык Выберите нужный язык. [по умолчанию: ru]
-v, --подробный вывод Печать подробных выходных данных.
-?, -h, --help (помощь) Показать справку и информацию об использовании.

Отправка — GetListingAssets — использование

msstore submission getListingAssets <productId>

Arguments

Аргумент Description
productId Идентификатор центра партнеров.

Options

Вариант Description
-l, --язык Выберите нужный язык. [по умолчанию: ru]
-v, --подробный вывод Печать подробных выходных данных.
-?, -h, --help (помощь) Показать справку и информацию об использовании.

Передача данных — ОбновлениеМетаданных — использование

msstore submission updateMetadata <productId> <metadata>

Arguments

Аргумент Description
productId Идентификатор центра партнеров.
metadata Обновленное представление метаданных JSON.

Options

Вариант Description
-s, --skipInitialPolling (пропустить начальное опрос) Пропустите начальный опрос перед выполнением действия. [по умолчанию: false]
-v, --подробный вывод Печать подробных выходных данных.
-?, -h, --help (помощь) Показать справку и информацию об использовании.

Отправка — обновление — использование

msstore submission update <productId> <package>

Arguments

Аргумент Description
productId Идентификатор центра партнеров.
package Обновленное представление JSON пакета приложения.

Options

Вариант Description
-s, --skipInitialPolling (пропустить начальное опрос) Пропустите начальный опрос перед выполнением действия. [по умолчанию: false]
-v, --подробный вывод Печать подробных выходных данных.
-?, -h, --help (помощь) Показать справку и информацию об использовании.

Подсказка

Используется submission get для получения текущего JSON пакета перед вызовом submission update. Это гарантирует, что вы работаете с правильной структурой и текущими значениями. Например, в 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

Дополнительные сведения см. в разделе Публикация обновлений приложений в Microsoft Store с использованием GitHub Actions.

Отправка — опрос — использование

msstore submission poll <productId>

Arguments

Аргумент Description
productId Идентификатор центра партнеров.

Options

Вариант Description
-v, --подробный вывод Печать подробных выходных данных.
-?, -h, --help (помощь) Показать справку и информацию об использовании.

Отправка — публикация — использование

msstore submission publish <productId>

Arguments

Аргумент Description
productId Идентификатор центра партнеров.

Options

Вариант Description
-v, --подробный вывод Печать подробных выходных данных.
-?, -h, --help (помощь) Показать справку и информацию об использовании.

Среды CI/CD

Интерфейс командной строки разработчика Microsoft Store (предварительная версия) поддерживает выполнение в средах CI/CD. Это означает, что вы можете использовать интерфейс командной строки разработчика Microsoft Store (предварительная версия) в конвейерах CI/CD, например автоматически публиковать приложения в Microsoft Store.

Первым шагом для достижения этой цели является установка предварительной версии CLI для разработчиков Microsoft Store в CI/CD среде. Здесь можно найти инструкции по этому способу.

После установки интерфейса командной строки разработчика Microsoft Store (предварительная версия) необходимо настроить среду для выполнения команд. Для этого msstore reconfigure выполните команду с определенными параметрами, определяющими учетную запись центра партнеров (TenantId, SellerId, ClientId). Кроме того, необходимо указать clientSecret или сертификат.

Очень важно скрыть эти учетные данные, так как они будут отображаться в журналах конвейера CI/CD. Это можно сделать с помощью секретов. Каждая система конвейера CI/CD имеет разные имена для этих секретов. Например, в Azure DevOps они называются Secret Variables, но в GitHub Actions их называют Encrypted Secrets. Создайте один секрет для каждого из параметров (TenantId, SellerId, ClientId и ClientSecret или Certificate), а затем используйте команду для настройки среды. reconfigure

Рассмотрим пример.

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 (інструменты для автоматизации задач в 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 }}

После выполнения этой команды интерфейс командной строки разработчика Microsoft Store (предварительная версия) будет настроен для использования предоставленных учетных данных. Теперь вы можете использовать интерфейс командной строки разработчика Microsoft Store (предварительная версия) в конвейере CI/CD.

  • Last updated on