Komutlar (MSI/EXE)

Kurulum

1. Adım: .NET Windows Çalışma Zamanı yükleme

Henüz yapmadıysanız .NET 8 Desktop Runtime en son sürümünü yükleyin. Bu, Microsoft Store Geliştirici CLI'sını çalıştırma gereksinimidir.

Bunu yüklemenin en kolay yolu winget kullanmaktır:

winget install Microsoft.DotNet.DesktopRuntime.8

2. Adım: Microsoft Store Geliştirici CLI'sini Windows'ye yükleme

Microsoft Store adresinden Microsoft Store Geliştirici CLI'sini indirebilirsiniz. Alternatif olarak , winget'i kullanabilirsiniz:

winget install "Microsoft Store Developer CLI"

1. Adım: macOS Runtime .NET yükleme

Henüz yapmadıysanız .NET 8 Runtime en son sürümünü yükleyin. Bu, Microsoft Store Geliştirici CLI'sını çalıştırma gereksinimidir.

2. Adım: macOS'ta Microsoft Store Geliştirici CLI'sini yükleme

Belirli mimariniz (x64 veya Arm64) için macOS .tar.gz dosyasını Microsoft Store Developer CLI yayınları sayfasından indirebilirsiniz. İndirildikten sonra, arşivi ayıklayın ve PATH'inize yerleştirin, ancak bunu yapmak isteyebilirsiniz, örneğin:

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

Alternatif olarak, brew kullanabilirsiniz:

brew install microsoft/msstore-cli/msstore-cli

1. Adım: .NET Linux Çalışma Zamanı yükleme

Henüz yapmadıysanız .NET 8 Runtime en son sürümünü yükleyin. Bu, Microsoft Store Geliştirici CLI'sını çalıştırma gereksinimidir.

2. Adım: Linux'ta Microsoft Store Geliştirici CLI'sini yükleme

Belirli mimariniz (x64 veya Arm64) için Linux .tar.gz dosyasını Microsoft Store Developer CLI yayınları sayfasından indirebilirsiniz. İndirildikten sonra, arşivi ayıklayın ve PATH'inize yerleştirin, ancak bunu yapmak isteyebilirsiniz, örneğin:

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

Alternatif olarak, brew kullanabilirsiniz:

brew install microsoft/msstore-cli/msstore-cli

Bilgi Komutu

Mevcut yapılandırmayı yazdırın.

Usage

msstore info

Options

Seçenek	Description
-v, --detaylı	Ayrıntılı çıktıyı yazdırın.
-?, -h, --yardım	Yardım ve kullanım bilgilerini gösterin.

Komutu Yeniden Yapılandır

Microsoft Store Geliştirici CLI'sını yeniden yapılandırın. İstemci Gizli Anahtarı veya Sertifika sağlayabilirsiniz. Sertifikalar, ya Parmak İzi aracılığıyla ya da (parola ile veya parolasız) bir dosya yolu aracılığıyla sağlanabilir.

Usage

msstore reconfigure

Options

Seçenek	Description
-t, --kiraciId	Kullanılacak kiracı kimliğini belirtin.
-s, --satıcıKimliği	Kullanılacak satıcı kimliğini belirtin.
-c, --müşteriId	Kullanılacak istemci kimliğini belirtin.
-cs, --istemciSırrı (clientSecret)	Kullanılacak istemci Sırrını belirtin.
-ct, --sertifikaParmakİzi	Kullanılması gereken sertifika parmak izini belirtin.
-cfp, --certificateFilePath (sertifika dosya yolu)	Kullanılacak sertifika dosyası yolunu belirtin.
-cp, --certificatePassword (sertifika parolası)	Kullanılacak sertifika parolasını belirtin.
--sıfırlama	Yeniden başlatmadan yalnızca kimlik bilgilerini sıfırlayın.
-v, --detaylı	Ayrıntılı çıktıyı yazdırın.
-?, -h, --yardım	Yardım ve kullanım bilgilerini gösterin.

Ayarlar Komutu

Microsoft Store Geliştirici CLI'sinin ayarlarını değiştirin.

Usage

msstore settings

Options

Seçenek	Description
-t, --telemetriyiEtkinleştir	Telemetriyi etkinleştir (boş/doğru) veya Devre Dışı Bırak (yanlış).
-v, --detaylı	Ayrıntılı çıktıyı yazdırın.
-?, -h, --yardım	Yardım ve kullanım bilgilerini gösterin.

SetPDN Alt-Komut

Publisher Display Name özelliğini ayarlayın.

Usage

msstore settings setpdn <publisherDisplayName>

Arguments

Argument	Description
publisherDisplayName	Küresel olarak belirlenecek Publisher Görünen Ad özelliği.

Options

Seçenek	Description
-?, -h, --yardım	Yardım ve kullanım bilgilerini gösterin.

Gönderme Komutu

Sub-Command	Description
durum	Gönderimin durumunu alır.
al	Belirli bir gönderimin meta verilerini ve paket bilgilerini alır.
getListingAssets	Belirli bir gönderimin listeleme varlıklarını alır.
updateMetadata	Belirli bir gönderimin meta verilerini güncelleştirir.
güncelleştirmek	Belirli bir gönderimin paket bilgilerini güncelleştirir.
Anket	Gönderimin durumunu sorgular.
yayınlamak	Belirli bir gönderimi yayımlar.

Gönderim - Durum - Kullanım

msstore submission status <productId>

Arguments

Argument	Description
productId	Partner Center kimliği.

Options

Seçenek	Description
-v, --detaylı	Ayrıntılı çıktıyı yazdırın.
-?, -h, --yardım	Yardım ve kullanım bilgilerini gösterin.

Gönder - Al - Kullanım

msstore submission get <productId>

Arguments

Argument	Description
productId	Partner Center kimliği.

Options

Seçenek	Description
-l, --dil	Almak istediğiniz dili seçin. [varsayılan: en]
-v, --detaylı	Ayrıntılı çıktıyı yazdırın.
-?, -h, --yardım	Yardım ve kullanım bilgilerini gösterin.

Gönderim - GetListingAssets - Kullanım

msstore submission getListingAssets <productId>

Arguments

Argument	Description
productId	Partner Center kimliği.

Options

Seçenek	Description
-l, --dil	Almak istediğiniz dili seçin. [varsayılan: en]
-v, --detaylı	Ayrıntılı çıktıyı yazdırın.
-?, -h, --yardım	Yardım ve kullanım bilgilerini gösterin.

Gönderim - MetaVeriGüncelleme - Kullanım

msstore submission updateMetadata <productId> <metadata>

Arguments

Argument	Description
productId	Partner Center kimliği.
metadata	Güncelleştirilmiş JSON meta veri gösterimi.

Options

Seçenek	Description
-s, --skipInitialPolling (ilk yoklamayı atla)	Eylemi yürütmeden önce ilk yoklamayı atlayın. [varsayılan: Yanlış]
-v, --detaylı	Ayrıntılı çıktıyı yazdırın.
-?, -h, --yardım	Yardım ve kullanım bilgilerini gösterin.

Gönderim - Güncelleştirme - Kullanım

msstore submission update <productId> <package>

Arguments

Argument	Description
productId	Partner Center kimliği.
package	Uygulama paketinin güncelleştirilmiş JSON gösterimi.

Options

Seçenek	Description
-s, --skipInitialPolling (ilk yoklamayı atla)	Eylemi yürütmeden önce ilk yoklamayı atlayın. [varsayılan: Yanlış]
-v, --detaylı	Ayrıntılı çıktıyı yazdırın.
-?, -h, --yardım	Yardım ve kullanım bilgilerini gösterin.

Tavsiye

submission get'yi çağırmadan önce, geçerli paket JSON'u almak için submission update kullanın. Bu, doğru yapı ve geçerli değerlerle çalışmanızı sağlar. Örneğin, PowerShell'de:

# 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

Daha fazla bağlam için bkz. GitHub Actions ile Microsoft Store'a uygulama güncellemelerini yayımlama.

Gönderim - Yoklama - Kullanım

msstore submission poll <productId>

Arguments

Argument	Description
productId	Partner Center kimliği.

Options

Seçenek	Description
-v, --detaylı	Ayrıntılı çıktıyı yazdırın.
-?, -h, --yardım	Yardım ve kullanım bilgilerini gösterin.

Gönderim - Yayımlama - Kullanım

msstore submission publish <productId>

Arguments

Argument	Description
productId	Partner Center kimliği.

Options

Seçenek	Description
-v, --detaylı	Ayrıntılı çıktıyı yazdırın.
-?, -h, --yardım	Yardım ve kullanım bilgilerini gösterin.

CI/CD Ortamları

Microsoft Store Geliştirici CLI'si (önizleme), CI/CD ortamlarında çalıştırmayı destekler. Bu, örneğin uygulamalarınızı Microsoft Store otomatik olarak yayımlamak için CI/CD işlem hatlarınızda Microsoft Store Geliştirici CLI'sini (önizleme) kullanabileceğiniz anlamına gelir.

Bunu başarmak için ilk adım, CI/CD ortamınıza Microsoft Store Geliştirici CLI'sini (önizleme) yüklemektir. Bunu nasıl yapacağınıza ilişkin yönergeleri burada bulabilirsiniz.

Microsoft Store Geliştirici CLI'sini (önizleme) yükledikten sonra, ortamınızı komutları çalıştırabilecek şekilde yapılandırmanız gerekir. Bunu yapmak için komutunu iş ortağı merkezi hesabınızı (msstore reconfigure, ClientId) tanımlayan belirli parametrelerle çalıştırabilirsiniz. Ayrıca ClientSecret veya Sertifika sağlamanız gerekir.

CI/CD işlem hattınızın günlüklerinde görünür olacağı için bu kimlik bilgilerini gizlemek çok önemlidir. Bunu gizliler kullanarak yapabilirsiniz. Her CI/CD işlem hattı sisteminin bu gizli diziler için farklı adları vardır. Örneğin, Azure DevOps bunlara Gizli Değişkenler der, ancak GitHub Action bunlara Şifreli Sırlar olarak adlandırır. Parametrelerin her biri (TenantId, SellerId, ClientId ve ClientSecret veya Bir Sertifika) için bir gizli dizi oluşturun ve ardından komutunu kullanarak reconfigure ortamınızı ayarlayın.

Örneğin:

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

Bu komut yürütüldükten sonra, Microsoft Store Geliştirici CLI'sı (önizleme) sağlanan kimlik bilgilerini kullanacak şekilde yapılandırılır. Artık CI/CD işlem hattınızda Microsoft Store Geliştirici CLI'sını (önizleme) kullanabilirsiniz.