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: Menginstal .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 Microsoft Store Developer CLI di macOS

Anda dapat mengunduh macOS .tar.gz untuk arsitektur spesifik Anda (x64 atau Arm64) dari halaman rilis Microsoft Store Developer CLI. 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: Menginstal .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 CLI Pengembang Microsoft Store di Linux

Anda dapat mengunduh Linux .tar.gz untuk arsitektur spesifik Anda (x64 atau Arm64) dari halaman rilis Microsoft Store Developer CLI. 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

Sebagai alternatif, Anda dapat menggunakan brew:

brew install microsoft/msstore-cli/msstore-cli

Perintah Informasi

Cetak konfigurasi yang ada.

Usage

msstore info

Opsi

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

Mengonfigurasi ulang Perintah

Konfigurasikan ulang Microsoft Store Developer CLI. 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, --idPenjual	Tentukan Id penjual yang harus digunakan.
-c, --clientId	Tentukan ID klien yang harus digunakan.
-cs, --clientSecret (kata sandi klien)	Tentukan Rahasia klien yang harus digunakan.
-ct, --sertifikatThumbprint	Tentukan Thumbprint sertifikat yang harus digunakan.
-cfp, --certificateFilePath	Tentukan jalur file sertifikat yang harus digunakan.
-cp, --kata sandi sertifikat	Tentukan kata sandi sertifikat yang harus digunakan.
--reset	Hanya atur ulang kredensial, tanpa memulai kembali.
-v, --serinci-mungkin	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, --serinci-mungkin	Cetak output yang rinci.
-?, -h, --help	Tampilkan bantuan dan informasi penggunaan.

SetPDN Subperintah

Atur properti Nama Tampilan Publisher.

Usage

msstore settings setpdn <publisherDisplayName>

Arguments

Argumen	Description
publisherDisplayName	Properti Nama Tampilan Publisher yang akan diatur 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, --serinci-mungkin	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. [standar: en]
-v, --serinci-mungkin	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, --bahasa	Pilih bahasa mana yang ingin Anda ambil. [standar: en]
-v, --serinci-mungkin	Cetak output yang rinci.
-?, -h, --help	Tampilkan bantuan dan informasi penggunaan.

Pengiriman - UpdateMetadata - Penggunaan

msstore submission updateMetadata <productId> <metadata>

Arguments

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

Opsi

Option	Description
-s, --lewatiPollingAwal	Lewati polling awal sebelum menjalankan tindakan. [nilai bawaan: False]
-v, --serinci-mungkin	Cetak output yang rinci.
-?, -h, --help	Tampilkan bantuan dan informasi penggunaan.

Pengiriman - Pembaruan - Penggunaan

msstore submission update <productId> <package>

Arguments

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

Opsi

Option	Description
-s, --lewatiPollingAwal	Lewati polling awal sebelum menjalankan tindakan. [nilai bawaan: False]
-v, --serinci-mungkin	Cetak output yang rinci.
-?, -h, --help	Tampilkan bantuan dan informasi penggunaan.

Petunjuk / Saran

Gunakan submission get untuk mengambil paket JSON saat ini sebelum memanggil submission update. Ini memastikan Anda bekerja dengan struktur dan nilai saat ini yang benar. Misalnya, di 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

Untuk konteks selengkapnya, lihat Publikasi pembaruan aplikasi ke Microsoft Store dengan GitHub Actions.

Pengajuan - Polling - Penggunaan

msstore submission poll <productId>

Arguments

Argumen	Description
productId	ID Mitra pusat.

Opsi

Option	Description
-v, --serinci-mungkin	Cetak output yang rinci.
-?, -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, --serinci-mungkin	Cetak output yang rinci.
-?, -h, --help	Tampilkan bantuan dan informasi penggunaan.

Lingkungan CI/CD

Microsoft Store Developer CLI (pratinjau) mendukung operasional di ekosistem CI/CD. Ini berarti Anda dapat menggunakan Microsoft Store Developer CLI (pratinjau) di alur 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 Secret Variables, 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

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

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) dalam pipeline CI/CD Anda.