Perintah (MSI/EXE)

Installation

Langkah 1: Instal .NET Windows Runtime

Jika Anda belum melakukannya, instal versi terbaru .NET 8 Desktop Runtime. Ini adalah persyaratan untuk menjalankan Microsoft Store Developer CLI.

Cara term mudah untuk menginstalnya adalah dengan menggunakan winget:

winget install Microsoft.DotNet.DesktopRuntime.8

Langkah 2: Instal Microsoft Store Developer CLI di Windows

Anda dapat mengunduh Microsoft Store Developer CLI dari Microsoft Store. Atau, Anda dapat menggunakan winget:

winget install "Microsoft Store Developer CLI"

Langkah 1: Instal .NET macOS Runtime

Jika Anda belum melakukannya, instal versi terbaru .NET 8 Runtime. Ini adalah persyaratan untuk menjalankan Microsoft Store Developer CLI.

Langkah 2: Instal CLI Pengembang Microsoft Store di macOS

Anda dapat mengunduh .tar.gz macOS untuk arsitektur spesifik Anda (x64 atau Arm64) dari halaman rilis CLI Pengembang Microsoft Store. Setelah diunduh, ekstrak arsip dan letakkan di PATH Anda dengan cara yang Anda inginkan, misalnya:

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

Sebagai alternatif, Anda dapat menggunakan brew:

brew install microsoft/msstore-cli/msstore-cli

Langkah 1: Instal .NET Linux Runtime

Jika Anda belum melakukannya, instal versi terbaru .NET 8 Runtime. Ini adalah persyaratan untuk menjalankan Microsoft Store Developer CLI.

Langkah 2: Instal Microsoft Store Developer CLI di Linux

Anda dapat mengunduh .tar.gz Linux untuk arsitektur spesifik Anda (x64 atau Arm64) dari halaman rilis CLI Pengembang Microsoft Store. Setelah diunduh, ekstrak arsip dan letakkan di PATH Anda, dengan cara yang Anda inginkan, misalnya:

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

Atau, Anda dapat menggunakan brew:

brew install microsoft/msstore-cli/msstore-cli

Perintah Informasi

Cetak konfigurasi yang ada.

Usage

msstore info

Opsi

Option	Description
-v, --verbose	Cetak output yang rinci.
-?, -h, --help	Tampilkan bantuan dan informasi penggunaan.

Mengonfigurasi ulang Perintah

Konfigurasikan ulang CLI Pengembang Microsoft Store. Anda dapat memberikan Rahasia Klien atau Sertifikat. Sertifikat dapat disediakan baik melalui Thumbprint-nya atau dengan menyediakan jalur file (dengan atau tanpa kata sandi).

Usage

msstore reconfigure

Opsi

Option	Description
-t, --tenantId	Tentukan Id penyewa yang harus digunakan.
-s, --sellerId	Tentukan Id penjual yang harus digunakan.
-c, --clientId	Tentukan ID klien yang harus digunakan.
-cs, --clientSecret	Tentukan Rahasia klien yang harus digunakan.
-ct, --sertifikatThumbprint	Tentukan Thumbprint sertifikat yang harus digunakan.
-cfp, --certificateFilePath	Tentukan jalur file sertifikat yang harus digunakan.
-cp, --certificatePassword	Tentukan kata sandi sertifikat yang harus digunakan.
--reset	Hanya atur ulang kredensial, tanpa memulai kembali.
-v, --verbose	Cetak output yang rinci.
-?, -h, --help	Tampilkan bantuan dan informasi penggunaan.

Perintah Pengaturan

Ubah pengaturan CLI Pengembang Microsoft Store.

Usage

msstore settings

Opsi

Option	Description
-t, --enableTelemetry (mengaktifkan Telemetri)	Aktifkan telemetri (kosong/benar) atau Nonaktifkan (false).
-v, --verbose	Cetak output yang rinci.
-?, -h, --help	Tampilkan bantuan dan informasi penggunaan.

SetPDN Sub-Command

Atur properti Nama Tampilan Publisher.

Usage

msstore settings setpdn <publisherDisplayName>

Arguments

Argumen	Description
publisherDisplayName	Properti Nama Tampilan Publisher yang akan disetel secara global.

Opsi

Option	Description
-?, -h, --help	Tampilkan bantuan dan informasi penggunaan.

Perintah Pengiriman

Sub-Perintah	Description
status	Mendapatkan status pengiriman.
mendapatkan	Mendapatkan metadata dan informasi paket dari pengajuan tertentu.
getListingAssets	Mendapatkan aset listing dari pengajuan tertentu.
updateMetadata	Memperbarui metadata pengiriman tertentu.
pemutakhiran	Memperbarui info paket pengiriman tertentu.
Jajak pendapat	Memeriksa status pengajuan.
menerbitkan	Menerbitkan suatu pengajuan tertentu.

Pengiriman - Status - Penggunaan

msstore submission status <productId>

Arguments

Argumen	Description
productId	ID Mitra pusat.

Opsi

Option	Description
-v, --verbose	Cetak output yang rinci.
-?, -h, --help	Tampilkan bantuan dan informasi penggunaan.

Pengajuan - Ambil - Penggunaan

msstore submission get <productId>

Arguments

Argumen	Description
productId	ID Mitra pusat.

Opsi

Option	Description
-l, --bahasa	Pilih bahasa mana yang ingin Anda ambil. [default: en]
-v, --verbose	Cetak output yang rinci.
-?, -h, --help	Tampilkan bantuan dan informasi penggunaan.

Pengajuan - GetListingAssets - Penggunaan

msstore submission getListingAssets <productId>

Arguments

Argumen	Description
productId	ID Mitra pusat.

Opsi

Option	Description
-l, --language	Pilih bahasa mana yang ingin Anda ambil. [default: en]
-v, --verbose	Cetak output yang rinci.
-?, -h, --help	Tampilkan bantuan dan informasi penggunaan.

Pengiriman - UpdateMetadata - Penggunaan

msstore submission updateMetadata <productId> <metadata>

Arguments

Argumen	Description
productId	ID pusat Mitra.
metadata	Representasi metadata JSON yang diperbarui.

Opsi

Option	Description
-s, --skipInitialPolling	Lewati polling awal sebelum menjalankan tindakan. [default: False]
-v, --rinci	Hasilkan output terperinci.
-?, -h, --help	Tampilkan bantuan dan informasi penggunaan.

Pengiriman - Pembaruan - Penggunaan

msstore submission update <productId> <package>

Arguments

Argumen	Description
productId	ID pusat Mitra.
package	Representasi JSON yang diperbarui dari paket aplikasi.

Opsi

Option	Description
-s, --lewatiPollingAwal	Lewati polling awal sebelum menjalankan tindakan. [default: False]
-v, --verbose (penjelasan lebih rinci)	Cetak keluaran terperinci.
-?, -h, --help	Tampilkan bantuan dan informasi penggunaan.

Pengajuan - Polling - Penggunaan

msstore submission poll <productId>

Arguments

Argumen	Description
productId	ID pusat Mitra.

Opsi

Option	Description
-v, --verbose	Cetak output terperinci.
-?, -h, --help	Tampilkan bantuan dan informasi penggunaan.

Pengiriman - Terbitkan - Penggunaan

msstore submission publish <productId>

Arguments

Argumen	Description
productId	ID Mitra pusat.

Opsi

Option	Description
-v, --rinci	Cetak output yang rinci.
-?, -h, --help	Tampilkan bantuan dan informasi penggunaan.

Lingkungan CI/CD

Microsoft Store Developer CLI (dalam pratinjau) mendukung operasional di lingkungan CI/CD. Ini berarti Anda dapat menggunakan Microsoft Store Developer CLI (pratinjau) di pipeline CI/CD Anda untuk, misalnya, secara otomatis menerbitkan aplikasi Anda ke Microsoft Store.

Langkah pertama untuk mencapainya adalah dengan menginstal Microsoft Store Developer CLI (pratinjau) di lingkungan CI/CD Anda. Anda dapat menemukan instruksi tentang cara melakukan ini di sini.

Setelah menginstal Microsoft Store Developer CLI (pratinjau), Anda harus mengonfigurasi lingkungan Anda untuk dapat menjalankan perintah. Anda dapat melakukan ini dengan menjalankan msstore reconfigure perintah dengan parameter tertentu yang mengidentifikasi akun pusat mitra Anda (TenantId, SellerId, ClientId). Anda juga perlu memberikan ClientSecret atau Sertifikat.

Sangat penting untuk menyembunyikan kredensial ini, karena akan terlihat di log alur CI/CD Anda. Anda dapat melakukan ini dengan menggunakan rahasia. Setiap sistem alur CI/CD memiliki nama yang berbeda untuk rahasia ini. Misalnya, Azure DevOps memanggilnya Variabel Rahasia, tetapi Tindakan GitHub memanggilnya Rahasia Terenkripsi. Buat satu rahasia untuk setiap parameter (TenantId, SellerId, ClientId, dan ClientSecret atau Sertifikat), lalu gunakan reconfigure perintah untuk menyiapkan lingkungan Anda.

Contohnya:

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

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

Setelah perintah ini dijalankan, Microsoft Store Developer CLI (pratinjau) akan dikonfigurasi untuk menggunakan kredensial yang disediakan. Sekarang Anda dapat menggunakan Microsoft Store Developer CLI (pratinjau) di alur CI/CD Anda.