Polecenia (MSI/EXE)

Instalacja

Krok 1: Instalowanie środowiska uruchomieniowego Windows dla platformy .NET

Jeśli jeszcze tego nie zrobiłeś, zainstaluj najnowszą wersję .NET 8 Desktop Runtime. Jest to wymóg do uruchamiania Microsoft Store Developer CLI.

Najprostszym sposobem instalacji jest użycie zestawu winget:

winget install Microsoft.DotNet.DesktopRuntime.8

Krok 2. Instalowanie interfejsu wiersza polecenia dewelopera sklepu Microsoft Store w systemie Windows

Możesz pobrać Microsoft Store Developer CLI ze sklepu Microsoft Store. Alternatywnie można użyć winget:

winget install "Microsoft Store Developer CLI"

Krok 1. Instalowanie środowiska uruchomieniowego .NET macOS

Jeśli jeszcze tego nie zrobiono, zainstaluj najnowszą wersję środowiska uruchomieniowego platformy .NET 8. Jest to wymóg do uruchomienia Microsoft Store Developer CLI.

Krok 2: Instalowanie CLI dewelopera sklepu Microsoft Store na macOS

Możesz pobrać .tar.gz systemu macOS dla określonej architektury (x64 lub Arm64) ze strony z wydaniami Microsoft Store Developer CLI. Po pobraniu wyodrębnij archiwum na swój komputer i skonfiguruj jego umiejscowienie w PATH, w dowolny sposób, na przykład:

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

Alternatywnie, możesz użyć brew:

brew install microsoft/msstore-cli/msstore-cli

Krok 1. Instalowanie środowiska uruchomieniowego .NET Linux

Jeśli jeszcze tego nie zrobiono, zainstaluj najnowszą wersję środowiska uruchomieniowego platformy .NET 8. Wymagane do uruchamiania Microsoft Store Developer CLI.

Krok 2. Instalowanie interfejsu wiersza polecenia dewelopera sklepu Microsoft Store w systemie Linux

Możesz pobrać plik .tar.gz dla systemu Linux i określonej architektury (x64 lub Arm64) ze strony wydań CLI dla deweloperów w sklepie Microsoft Store. Po pobraniu wyodrębnij archiwum i umieść je w swoim PATH według własnych preferencji, na przykład:

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

Alternatywnie możesz użyć brew:

brew install microsoft/msstore-cli/msstore-cli

Polecenie Info

Drukuj istniejącą konfigurację.

Usage

msstore info

Opcje

Option	Description
-v, --verbose	Drukuj pełne dane wyjściowe.
-?, -h, --help	Pokaż informacje o pomocy i użyciu.

Ponowne konfigurowanie polecenia

Ponownie skonfiguruj Microsoft Store Developer CLI. Możesz podać klucz tajny klienta lub certyfikat. Certyfikaty mogą być udostępniane za pomocą odcisku palca lub przez podanie ścieżki pliku (z hasłem lub bez tego hasła).

Usage

msstore reconfigure

Opcje

Option	Description
-t, --tenantId	Określ identyfikator dzierżawy, który ma być używany.
-s, --sellerId	Określ identyfikator sprzedawcy, który ma być używany.
-c, --clientId	Określ identyfikator klienta, który ma być używany.
-cs, --clientSecret	Określ klucz tajny klienta, który ma być używany.
-ct, --certificateThumbprint	Określ odcisk palca certyfikatu, który ma być używany.
-cfp, --certificateFilePath	Określ ścieżkę pliku certyfikatu, która ma być używana.
-cp, --certificatePassword	Określ hasło certyfikatu, które ma być używane.
--resetować	Zresetuj tylko poświadczenia, bez rozpoczynania od nowa.
-v, --verbose	Drukuj pełne dane wyjściowe.
-?, -h, --help	Pokaż informacje o pomocy i użyciu.

Ustawienia polecenie

Zmień ustawienia w narzędziu dla deweloperów Microsoft Store CLI.

Usage

msstore settings

Opcje

Option	Description
-t, --enableTelemetry	Włącz (puste/true) lub Wyłącz (fałsz) dane telemetryczne.
-v, --verbose (szczegółowy)	Drukuj pełne dane wyjściowe.
-?, -h, --help	Pokaż informacje o pomocy i użyciu.

Polecenie podrzędne SetPDN

Ustaw właściwość dla nazwy wyświetlanej wydawcy.

Usage

msstore settings setpdn <publisherDisplayName>

Arguments

Argument	Description
publisherDisplayName	Właściwość Nazwa wyświetlana wydawcy, która zostanie ustawiona globalnie.

Opcje

Option	Description
-?, -h, --help	Pokaż informacje o pomocy i użyciu.

Polecenie przesyłania

Polecenie podrzędne	Description
stan	Pobiera status zgłoszenia.
Pobierz	Pobiera metadane oraz informacje o pakiecie określonego zgłoszenia.
getListingAssets	Pobiera zasoby wykazu określonego zgłoszenia.
updateMetadata	Aktualizuje metadane określonego przesłania.
aktualizacja	Aktualizuje dane pakietu dotyczące konkretnego zgłoszenia.
ankieta	Sonduje stan przesłania.
publikować	Publikuje określone zgłoszenie.

Przesyłanie — stan — użycie

msstore submission status <productId>

Arguments

Argument	Description
productId	Identyfikator Centrum partnerskiego.

Opcje

Option	Description
-v, --szczegółowe-logi	Drukuj pełne dane wyjściowe.
-?, -h, --help	Pokaż informacje o pomocy i użyciu.

Przesyłanie — pobieranie — użycie

msstore submission get <productId>

Arguments

Argument	Description
productId	Identyfikator Centrum partnerskiego.

Opcje

Option	Description
-l, --language	Wybierz język, który chcesz pobrać. [ustawienie domyślne: en]
-v, --szczegółowy	Drukuj pełne dane wyjściowe.
-?, -h, --help	Pokaż informacje o pomocy i użyciu.

Przesyłanie — GetListingAssets — Użycie

msstore submission getListingAssets <productId>

Arguments

Argument	Description
productId	Identyfikator Centrum partnerskiego.

Opcje

Option	Description
-l, --language	Wybierz język, który chcesz pobrać. [ustawienie domyślne: en]
-v, --verbose	Drukuj pełne dane wyjściowe.
-?, -h, --help	Pokaż informacje o pomocy i użyciu.

Przesyłanie — UpdateMetadata — użycie

msstore submission updateMetadata <productId> <metadata>

Arguments

Argument	Description
productId	Identyfikator Centrum partnerskiego.
metadata	Zaktualizowana reprezentacja metadanych JSON.

Opcje

Option	Description
-s, --skipInitialPolling	Pomiń wstępne sondowanie przed wykonaniem akcji. [wartość domyślna: Fałsz]
-v, --verbose	Drukuj pełne dane wyjściowe.
-?, -h, --help	Pokaż informacje o pomocy i użyciu.

Przesyłanie — aktualizacja — użycie

msstore submission update <productId> <package>

Arguments

Argument	Description
productId	Identyfikator Centrum partnerskiego.
package	Zaktualizowana reprezentacja JSON pakietu aplikacji.

Opcje

Option	Description
-s, --skipInitialPolling (pominięcie początkowego sondowania)	Pomiń wstępne sondowanie przed wykonaniem akcji. [wartość domyślna: Fałsz]
-v, --verbose	Drukuj pełne dane wyjściowe.
-?, -h, --help	Pokaż informacje o pomocy i użyciu.

Przesyłanie — ankieta — użycie

msstore submission poll <productId>

Arguments

Argument	Description
productId	Identyfikator Centrum partnerskiego.

Opcje

Option	Description
-v, --verbose	Drukuj pełne dane wyjściowe.
-?, -h, --help	Pokaż informacje o pomocy i użyciu.

Przesyłanie — publikowanie — użycie

msstore submission publish <productId>

Arguments

Argument	Description
productId	Identyfikator Centrum partnerskiego.

Opcje

Option	Description
-v, --verbose	Drukuj pełne dane wyjściowe.
-?, -h, --help	Pokaż informacje o pomocy i użyciu.

Środowiska ciągłej integracji/ciągłego wdrażania

Interfejs wiersza polecenia (CLI) dla deweloperów Microsoft Store (wersja zapoznawcza) obsługuje uruchamianie w środowiskach CI/CD. Oznacza to, że możesz użyć Microsoft Store Developer CLI (wersja zapoznawcza) w potokach CI/CD, na przykład do automatycznego publikowania aplikacji w sklepie Microsoft Store.

Pierwszym krokiem do osiągnięcia tego celu jest zainstalowanie Microsoft Store Developer CLI (wersja zapoznawcza) w środowisku CI/CD. Instrukcje dotyczące wykonywania tych czynności można znaleźć tutaj.

Po zainstalowaniu interfejsu wiersza polecenia dla deweloperów sklepu Microsoft Store (wersja zapoznawcza) musisz skonfigurować środowisko, aby móc uruchamiać polecenia. Możesz to zrobić, uruchamiając msstore reconfigure polecenie z określonymi parametrami identyfikującymi konto Centrum partnerskiego (TenantId, SellerId, ClientId). Należy również podać sekretny klucz ClientSecret lub Certyfikat.

Bardzo ważne jest ukrycie tych poświadczeń, gdyż mogą być widoczne w dziennikach twojego potoku CI/CD. Można to zrobić za pomocą sekretów. Każdy system potoków CI/CD ma różne nazwy dla tych sekretów. Na przykład usługa Azure DevOps nazywa je zmiennymi tajnymi, ale GitHub Actions nazywa je zaszyfrowanymi tajemnicami. Utwórz jeden wpis tajny dla każdego z parametrów (TenantId, SellerId, ClientId i ClientSecret lub Certificate), a następnie użyj reconfigure polecenia , aby skonfigurować środowisko.

Przykład:

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

Po wykonaniu tego polecenia Microsoft Store Developer CLI (wersja zapoznawcza) zostanie skonfigurowany do używania podanych poświadczeń. Teraz możesz użyć Microsoft Store Developer CLI (wersja zapoznawcza) w swoim potoku CI/CD.