Parancsok (MSIX)

Telepítés

1. lépés: .NET Windows-futtatókörnyezet telepítése

Ha még nem tette meg, telepítse a .NET 9 asztali futtatókörnyezet legújabb verzióját. Ez a Microsoft Store fejlesztői parancssori felület futtatásának követelménye.

A telepítés legegyszerűbb módja a winget használata:

winget install Microsoft.DotNet.DesktopRuntime.9

2. lépés: A Microsoft Store fejlesztői parancssori felület telepítése Windows

Letöltheti a Microsoft Store fejlesztői parancssori felületét a Microsoft Store-ból. Másik lehetőségként használhatja a winget:

winget install "Microsoft Store Developer CLI"

1. lépés: .NET macOS Runtime telepítése

Ha még nem tette meg, telepítse a .NET 9 futtatókörnyezet legújabb verzióját. Ez a Microsoft Store fejlesztői parancssori felület futtatásának követelménye.

2. lépés: A Microsoft Store fejlesztői parancssori felület telepítése macOS rendszeren

Letöltheti a macOS .tar.gz fájlt az adott architektúrához (x64 vagy Arm64) a Microsoft Store Fejlesztői CLI kiadási oldaláról. Miután letöltötte az archívumot, bontsa ki, és helyezze el az elérési útvonalba, tetszőleges módon, például:

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

Másik lehetőségként használhatja a brew-t:

brew install microsoft/msstore-cli/msstore-cli

1. lépés: .NET Linux-futtatókörnyezet telepítése

Ha még nem tette meg, telepítse a .NET 9 futtatókörnyezet legújabb verzióját. Ez a Microsoft Store fejlesztői parancssori felület futtatásának követelménye.

2. lépés: A Microsoft Store fejlesztői parancssori felület telepítése Linuxon

A linuxos .tar.gz az adott architektúrához (x64 vagy Arm64) a Microsoft Store Fejlesztői CLI kiadási oldaláról töltheti le. Miután letöltötte az archívumot, bontsa ki, és helyezze el az elérési útvonalba, tetszőleges módon, például:

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

Másik lehetőségként használhatja a brew-t:

brew install microsoft/msstore-cli/msstore-cli

Információ parancs

Meglévő konfiguráció nyomtatása.

Usage

msstore info

Beállítások

Lehetőség Leírás
-v, --részletes Részletes kimenet megjelenítése.
-?, -h, --help Súgó- és használati adatok megjelenítése.

Parancs újrakonfigurálása

Konfigurálja újra a Microsoft Store fejlesztői parancssori felületet. Megadhat egy ügyfélkulcsot vagy egy tanúsítványt. A tanúsítványok az ujjlenyomatán keresztül vagy egy fájl elérési útján (jelszóval vagy jelszó nélkül) is megadhatóak.

Usage

msstore reconfigure

Beállítások

Lehetőség Leírás
-t, --tenantId Adja meg a használni kívánt bérlőazonosítót.
-s, --eladóAzonító Adja meg a használni kívánt eladóazonosítót.
-c, --ügyfélAzonosító Adja meg a használni kívánt ügyfél-azonosítót.
-cs, --clientSecret (kliens titkos kulcs) Adja meg a használni kívánt ügyfélkulcsot.
-ct, --tanúsítványUjjlenyomat Adja meg a használni kívánt tanúsítvány ujjlenyomatát.
-cfp, --certificateFilePath (tanúsítványfájl elérési út) Adja meg a használni kívánt tanúsítványfájl elérési útját.
-cp, --certificatePassword (tanúsítvány jelszó) Adja meg a használni kívánt tanúsítványjelszót.
--átszed Csak a hitelesítő adatok alaphelyzetbe állítása újrakezdés nélkül.
-v, --részletes Részletes kimenet megjelenítése.
-?, -h, --help Súgó- és használati adatok megjelenítése.

Beállítások parancs

Módosítsa a Microsoft Store fejlesztői parancssori felület beállításait.

Usage

msstore settings

Beállítások

Lehetőség Leírás
-t, --telemetria engedélyezése Engedélyezze (üres/igaz) vagy tiltsa le a (hamis) telemetriát.
-v, --részletes Részletes kimenet megjelenítése.
-?, -h, --help Súgó- és használati adatok megjelenítése.

SetPDN alsó parancs

Állítsa be az init parancs által használt Publisher Megjelenítendő név tulajdonságot.

Usage

msstore settings setpdn <publisherDisplayName>

Érvek

érvelés Leírás
publisherDisplayName A globálisan beállított Publisher Megjelenítési név tulajdonság.

Beállítások

Lehetőség Leírás
-?, -h, --help Súgó- és használati adatok megjelenítése.

Alkalmazások parancs

Sub-Command Leírás
lista A fiók összes alkalmazásának listája.
kap Lekéri egy adott alkalmazás részleteit.

Alkalmazások – Lista – Használat

msstore apps list

Beállítások

Lehetőség Leírás
-v, --részletes Részletes kimenet megjelenítése.
-?, -h, --help Súgó- és használati adatok megjelenítése.

Alkalmazások – Lekérés – Használat

msstore apps get <productId>

Érvek

érvelés Leírás
productId Az Áruház termékazonosítója.

Beállítások

Lehetőség Leírás
-v, --részletes Részletes kimenet megjelenítése.
-?, -h, --help Súgó- és használati adatok megjelenítése.

Küldési parancs

Sub-Command Leírás
állapot Megtekinti a beküldés állapotát.
kap Lekéri egy adott beküldés metaadatait és csomagadatait.
getListingAssets Lekéri egy adott benyújtás listázási elemeit.
updateMetadata Frissíti egy adott beküldés metaadatait.
frissít Frissíti egy adott beküldés csomagját.
szavazás Lekérdezi a beküldés állapotát.
közzétesz Egy adott beküldés közzététele.
töröl Töröl egy adott beküldést.

Beküldés – Állapot – Használat

msstore submission status <productId>

Érvek

érvelés Leírás
productId Az Áruház termékazonosítója.

Beállítások

Lehetőség Leírás
-v, --részletes Részletes kimenet megjelenítése.
-?, -h, --help Súgó- és használati adatok megjelenítése.

Beküldés – Lekérés – Használat

msstore submission get <productId>

Érvek

érvelés Leírás
productId Az Áruház termékazonosítója.

Beállítások

Lehetőség Leírás
-v, --részletes Részletes kimenet megjelenítése.
-?, -h, --help Súgó- és használati adatok megjelenítése.

Beküldés – GetListingAssets – Használat

msstore submission getListingAssets <productId>

Érvek

érvelés Leírás
productId Az Áruház termékazonosítója.

Beállítások

Lehetőség Leírás
-v, --részletes Részletes kimenet megjelenítése.
-?, -h, --help Súgó- és használati adatok megjelenítése.

Beküldés – UpdateMetadata – Használat

msstore submission updateMetadata <productId> <metadata>

Érvek

érvelés Leírás
productId Az Áruház termékazonosítója.
metadata A frissített JSON-metaadatok megjelenítése.

Beállítások

Lehetőség Leírás
-s, --skipInitialPolling (kezdeti lekérdezés kihagyása) A művelet végrehajtása előtt hagyja ki a kezdeti lekérdezést. [alapértelmezett: Hamis]
-v, --részletes Részletes kimenet megjelenítése.
-?, -h, --help Súgó- és használati adatok megjelenítése.

Beküldés – Frissítés – Használat

msstore submission update <productId> <package>

Érvek

érvelés Leírás
productId Az Áruház termékazonosítója.
package Az alkalmazáscsomag frissített JSON-ábrázolása.

Beállítások

Lehetőség Leírás
-s, --skipInitialPolling (kezdeti lekérdezés kihagyása) A művelet végrehajtása előtt hagyja ki a kezdeti lekérdezést. [alapértelmezett: Hamis]
-v, --részletes Részletes kimenet megjelenítése.
-?, -h, --help Súgó- és használati adatok megjelenítése.

Jótanács

Az submission get aktuális csomag JSON-jának lekéréséhez használja az submission update szolgáltatást. Ez biztosítja, hogy a megfelelő struktúrával és az aktuális értékekkel dolgozzon. Például a PowerShellben:

# 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

# Step 3: Pass the updated JSON to submission update
$updatedPackage = Get-Content -Raw package.json
msstore submission update <productId> $updatedPackage

További kontextusért lásd A Microsoft Store alkalmazásfrissítések közzététele a GitHub Actions segítségével.

Beküldés – Szavazás – Használat

msstore submission poll <productId>

Érvek

érvelés Leírás
productId Az Áruház termékazonosítója.

Beállítások

Lehetőség Leírás
-v, --részletes Részletes kimenet megjelenítése.
-?, -h, --help Súgó- és használati adatok megjelenítése.

Beküldés – Közzététel – Használat

msstore submission publish <productId>

Érvek

érvelés Leírás
productId Az Áruház termékazonosítója.

Beállítások

Lehetőség Leírás
-v, --részletes Részletes kimenet megjelenítése.
-?, -h, --help Súgó- és használati adatok megjelenítése.

Beküldés – Törlés – Használat

msstore submission delete <productId>

Érvek

érvelés Leírás
productId Az Áruház termékazonosítója.

Beállítások

Lehetőség Leírás
--nincs-megerősítés Ne kérje a megerősítést. [alapértelmezett: Hamis]
-v, --részletes Részletes kimenet megjelenítése.
-?, -h, --help Súgó- és használati adatok megjelenítése.

Járatparancsok

Sub-Command Leírás
lista Lekéri a megadott alkalmazás összes járatát.
kap Lekéri a megadott alkalmazáshoz és járathoz tartozó járatot.
töröl Törli a megadott alkalmazáshoz és járathoz tartozó járatot.
create Létrehoz egy repülőjáratot a megadott alkalmazáshoz és járathoz.
beküldés Repülési beküldésekkel kapcsolatos feladatok elvégzése.

Járatok - Listázó parancs használata

msstore flights list <productId>

Járatok – Parancs argumentumainak listázása

érvelés Leírás
productId A termékazonosító.

Járatok – Lista parancs súgója

msstore flights list --help

Járatok – Parancshasználat lekérése

msstore flights get <productId> <flightId>

Járatok – Parancsargumentumok lekérései

érvelés Leírás
productId A termékazonosító.
flightId A járatazonosító.

Járatok – Parancs súgójának lekérése

msstore flights get --help

Járatok – Törlési parancs használata

msstore flights delete <productId> <flightId>

Járatok – Parancsargumentumok törlése

érvelés Leírás
productId A termékazonosító.
flightId A járatazonosító.

Járatok – Törlés parancs súgója

msstore flights delete --help

Járatok – Parancshasználat létrehozása

msstore flights create <productId> <friendlyName> --group-ids <group-ids>

Járatok – Parancsargumentumok létrehozása

érvelés Leírás
productId A termékazonosító.
friendlyName A járat barátságos neve.

Járatok – Parancsbeállítások létrehozása

Lehetőség Leírás
-g, --group-ids (csoportazonosítók) A járathoz társítandó csoportazonosítók.
-r, --rank-higher-than (rangsorolja magasabbra mint) A repülési azonosító, amely magasabb rangot ér el.

Járatok – Parancs létrehozási súgó

msstore flights create --help

Járatok – Beküldési parancs

Sub-Command Leírás
kap Lekéri a csomag meglévő benyújtását, akár a meglévő tervezetet, akár az utolsó közzétett csomagot.
töröl Törli a függőben lévő csomag beküldési kérelmet a Store-ból.
frissít Frissíti a meglévő repülési vázlatot a megadott JSON-val.
közzétesz Elindítja a meglévő piszkozat repülési beküldési folyamatát.
szavazás Mindaddig ismétlődő lekérdezéseket végez, amíg a meglévő járatbeküldés KÖZZÉ nem került vagy SIKERTELEN lett.
állapot Lekéri az áruház járatbeküldésének aktuális állapotát.
Bevezetés A repülési bevezetéssel kapcsolatos műveletek végrehajtása.

Járatok – Beküldési GET parancs használata

msstore flights submission get <productId> <flightId>

Járatok – Beküldés – Parancsargumentumok lekérése

érvelés Leírás
productId A termékazonosító.
flightId A járatazonosító.

Járatok – Beküldés – Parancs lekérése – súgó

msstore flights submission get --help

Járatok – Küldés törlési parancshasználata

msstore flights submission delete <productId> <flightId>

Járatok – Küldés törlése parancsargumentumok

érvelés Leírás
productId A termékazonosító.
flightId A járatazonosító.

Járatok – Beküldés törlési parancs súgója

msstore flights submission delete --help

Járatok – Beküldési frissítés parancs használata

msstore flights submission update <productId> <flightId> <product>

Járatok – Adatbeküldési frissítési parancs argumentumai

érvelés Leírás
productId A termékazonosító.
flightId A járatazonosító.
product A frissített JSON-termékábrázolás.

Járatok – Beküldési frissítés parancsopciók

Lehetőség Leírás
-s, --skipInitialPolling (kezdeti lekérdezés kihagyása) A művelet végrehajtása előtt hagyja ki a kezdeti lekérdezést. [alapértelmezett: Hamis]

Járatok – Küldési frissítés parancs súgója

msstore flights submission update --help

Járatok – Küldés – Parancs használatának közzététele

msstore flights submission publish <productId> <flightId>

Járatok – Küldés – Közzététel parancs paraméterei

érvelés Leírás
productId A termékazonosító.
flightId A járatazonosító.

Járatok – Küldés közzétételi parancs súgója

msstore flights submission publish --help

Járatok – Beküldési lekérdezési parancs használata

msstore flights submission poll <productId> <flightId>

Járatok – Szavazási parancs argumentumainak beküldése

érvelés Leírás
productId A termékazonosító.
flightId A járatazonosító.

Járatok – Beküldés szavazási parancs segítsége

msstore flights submission poll --help

Járatok – Küldési állapot parancs használata

msstore flights submission status <productId> <flightId>

Járatok – Küldési állapot parancs argumentumai

érvelés Leírás
productId A termékazonosító.
flightId A járatazonosító.

Repülőjáratok – Küldési állapot parancs súgója

msstore flights submission status --help

Járatok – Beküldés – Bevezetési parancs

Sub-Command Leírás
kap Lekéri egy beküldés repülési bevezetési állapotát.
frissít Frissítse a beküldések repülési bevezetési százalékos arányát.
Megállás A beküldés repülési bevezetésének leállítása.
Véglegesítse Véglegesíti a beküldés repülési bevezetésének véglegesítését.

Járatok – Beküldés – Bevezetés parancs használatának lekérdezése

msstore flights submission rollout get <productId> <flightId>

Járatok – Beküldés – Bevezetés parancsargumentumok lekérése

érvelés Leírás
productId A termékazonosító.
flightId A járatazonosító.

Járatok – Beküldés – Bevezetés – Parancsbeállítások lekérése

Lehetőség Leírás
-s, --beküldésiAzonosító A beküldés azonosítója.

Járatok – Beküldés – Bevezetés – Parancs súgójának lekérése

msstore flights submission rollout get --help

Járatok – Beküldés – Bevezetési frissítés parancs használata

msstore flights submission rollout update <productId> <flightId> <percentage>

Járatok – Beküldés – Bevezetési frissítés parancs argumentumai

érvelés Leírás
productId A termékazonosító.
flightId A járatazonosító.
percentage A beküldés bevezetését fogadó felhasználók százalékos aránya.

Járatok – Beküldés – Bevezetési frissítés parancs beállításai

Lehetőség Leírás
-s, --beküldésiAzonosító A beküldés azonosítója.

Járatok – Beküldés – Bevezetési frissítés parancs súgója

msstore flights submission rollout update --help

Járatok – Beküldés – A bevezetés leállítása parancs használata

msstore flights submission rollout halt <productId> <flightId>

Járatok – Beküldés – Telepítés leállítása parancs argumentumai

érvelés Leírás
productId A termékazonosító.
flightId A járatazonosító.

Járatok – Beküldés – Telepítés leállítása parancsbeállítások

Lehetőség Leírás
-s, --beküldésiAzonosító A beküldés azonosítója.

Járatok – Beküldés – Bevezetés leállítása parancs súgója

msstore flights submission rollout halt --help

Járatok – Beküldés – Bevezetés a parancshasználat véglegesítésére

msstore flights submission rollout finalize <productId> <flightId>

Járatok – Beküldés – Bevezetés – Parancsargumentumok véglegesítése

érvelés Leírás
productId A termékazonosító.
flightId A járatazonosító.

Járatok – Beküldés – Bevezetés – Parancsbeállítások véglegesítése

Lehetőség Leírás
-s, --beküldésiAzonosító A beküldés azonosítója.

Repülőjáratok – Beküldés – Bevezetés – Parancs súgójának véglegesítése

msstore flights submission rollout finalize --help

Inicializálási parancs

A init paranccsal beállíthatja az alkalmazást a Microsoft Store való közzétételhez. Jelenleg a következő alkalmazástípusokat támogatja:

  • WinUI
  • .NET MAUI
  • Lebeg
  • Elektron
  • React Native asztali számítógépre
  • PWA
  • UWP

Használati példák

Windows App SDK/WinUI

msstore init "C:\path\to\winui3_app"

UWP

msstore init "C:\path\to\uwp_app"

.NET MAUI

msstore init "C:\path\to\maui_app"

Lebeg

msstore init "C:\path\to\flutter_app"

Elektron

msstore init "C:\path\to\electron_app"

React Native asztali számítógépre

msstore init "C:\path\to\react_native_app"

Megjegyzés:

Az Electron és a React Native for Desktop projektek esetében mind a Npm, mind a Yarn támogatott. A Yarn zárolási fájl (yarn.lock) megléte alapján kerül meghatározásra, hogy melyik csomagkezelőt használja, ezért biztosítsa, hogy feltölti a zárolási fájlt a forrásvezérlő rendszerbe.

PWA

msstore init https://contoso.com --output .

Érvek

érvelés Leírás
pathOrUrl A gyökérkönyvtár elérési útvonala, ahol a projektfájl található, vagy egy PWA-ra mutató nyilvános URL-cím.

Beállítások

Lehetőség Leírás
-n, --kiadóMegjelenítésiNév Az alkalmazás konfigurálásához használt Publisher megjelenítendő név. Ha meg van adva, elkerülheti a további API-k hívását.
--csomag Ha az alkalmazás típusa támogatja, automatikusan csomagolja a projektet.
--közzétesz Ha az alkalmazástípus támogatja, automatikusan közzéteszi a projektet. A(z) '--package true' jelentése az, hogy
-f, --járatAzonosító Megadja azt a járatazonosítót, ahol a csomag közzé lesz téve.
-prp, --csomagKibocsátásiSzázalék A csomag bevezetési százalékát adja meg. Az értéknek 0 és 100 közöttinek kell lennie.
-a, --arch (architektúra beállítása a parancssorban) A felépítendő architektúra(ok). Ha nincs megadva, az aktuális operációs rendszer alapértelmezett architektúrája és projekttípusa lesz használatban. Engedélyezett értékek: "x86", "x64", "arm64". Csak a "--package true" kifejezéssel együtt használták.
-o, --kimenet A kimeneti könyvtár, amelyben a csomagolt alkalmazás lesz tárolva. Ha nincs megadva, a rendszer az egyes alkalmazástípusok alapértelmezett könyvtárát használja.
-ver, --verzió Az alkalmazás létrehozásakor használt verzió. Ha nincs megadva, a program a projektfájlból származó verziót használja.

Parancs csomagkezeléshez

Segít a Microsoft Store alkalmazás MSIX-ként való csomagolásában.

Használati példák

Windows App SDK/WinUI

msstore package "C:\path\to\winui3_app"

WinUI

msstore package "C:\path\to\uwp_app"

.NET MAUI

msstore package "C:\path\to\maui_app"

Lebeg

msstore package "C:\path\to\flutter_app"

Elektron

msstore package "C:\path\to\electron_app"

React Native asztali számítógépre

msstore package "C:\path\to\react_native_app"

PWA

msstore package "C:\path\to\pwa_app"

Érvek

Lehetőség Leírás
pathOrUrl A gyökérkönyvtár elérési útvonala, ahol a projektfájl található, vagy egy PWA-ra mutató nyilvános URL-cím.

Beállítások

Lehetőség Leírás
-o, --kimenet A kimeneti könyvtár, amelyben a csomagolt alkalmazás lesz tárolva. Ha nincs megadva, a rendszer az egyes alkalmazástípusok alapértelmezett könyvtárát használja.
-a, --arch (architektúra beállítása a parancssorban) A felépítendő architektúra(ok). Ha nincs megadva, az aktuális operációs rendszer alapértelmezett architektúrája és projekttípusa lesz használatban. Engedélyezett értékek: "x86", "x64", "arm64".
-ver, --verzió Az alkalmazás létrehozásakor használt verzió. Ha nincs megadva, a program a projektfájlból származó verziót használja.

Közzétételi parancs

Közzéteszi az Ön alkalmazását a Microsoft Store-ban.

Használati példák

Windows App SDK/WinUI

msstore publish "C:\path\to\winui3_app"

WinUI

msstore publish "C:\path\to\uwp_app"

.NET MAUI

msstore publish "C:\path\to\maui_app"

Lebeg

msstore publish "C:\path\to\flutter_app"

Elektron

msstore publish "C:\path\to\electron_app"

React Native asztali számítógépre

msstore publish "C:\path\to\react_native_app"

PWA

msstore publish "C:\path\to\pwa_app"

Érvek

Lehetőség Leírás
pathOrUrl A gyökérkönyvtár elérési útvonala, ahol a projektfájl található, vagy egy PWA-ra mutató nyilvános URL-cím.

Beállítások

Lehetőség Leírás
-i, --bemenetiFájl A közzétételi parancshoz használandó ".msix" vagy ".msixupload" fájl elérési útja. Ha nincs megadva, a parancssori felület megpróbálja megtalálni a legjobb jelöltet a "pathOrUrl" argumentum alapján.
-id, --alkalmazásazonosító Az alkalmazásazonosítót adja meg. Csak akkor van szükség, ha a projektet még nem inicializálták az "init" paranccsal.
-nc, --nincsElkötelezettség Letiltja a beküldés véglegesítését, és piszkozat állapotban tartja.
-f, --járatAzonosító Megadja azt a járatazonosítót, ahol a csomag közzé lesz téve.
-prp, --csomagKibocsátásiSzázalék A csomag bevezetési százalékát adja meg. Az értéknek 0 és 100 közöttinek kell lennie.

Járatok parancs

Sub-Command Leírás
lista Lekéri a megadott alkalmazás összes járatát.
kap Lekéri a megadott alkalmazáshoz és járathoz tartozó járatot.
töröl Törli a megadott alkalmazáshoz és járathoz tartozó járatot.
create Létrehoz egy repülőjáratot a megadott alkalmazáshoz és járathoz.
beküldés Repülési beküldésekkel kapcsolatos feladatok elvégzése.

Járatok – Lista – Használat

msstore flights list <productId>

Érvek

érvelés Leírás
productId A termékazonosító.

Beállítások

Lehetőség Leírás
-v, --részletes Részletes kimenet megjelenítése.
-?, -h, --help Súgó- és használati adatok megjelenítése.

Járatok – Lekérdezés – Használat

msstore flights get <productId> <flightId>

Érvek

érvelés Leírás
productId A termékazonosító.
flightId A járatazonosító.

Beállítások

Lehetőség Leírás
-v, --részletes Részletes kimenet megjelenítése.
-?, -h, --help Súgó- és használati adatok megjelenítése.

Járatok – Törlés – Használat

msstore flights delete <productId> <flightId>

Érvek

érvelés Leírás
productId A termékazonosító.
flightId A járatazonosító.

Beállítások

Lehetőség Leírás
-v, --részletes Részletes kimenet megjelenítése.
-?, -h, --help Súgó- és használati adatok megjelenítése.

Járatok – Létrehozás – Használat

msstore flights create <productId> <friendlyName> --group-ids <group-ids>

Érvek

érvelés Leírás
productId A termékazonosító.
friendlyName A járat barátságos neve.

Beállítások

Lehetőség Leírás
-g, --group-ids (csoportazonosítók) A járathoz társítandó csoportazonosítók.
-r, --rank-higher-than (rangsorolja magasabbra mint) A repülési azonosító, amely magasabb rangot ér el.
-v, --részletes Részletes kimenet megjelenítése.
-?, -h, --help Súgó- és használati adatok megjelenítése.

Járatok – Beküldés

Sub-Command Leírás
kap Lekéri a csomag meglévő benyújtását, akár a meglévő tervezetet, akár az utolsó közzétett csomagot.
töröl Törli a függőben lévő csomag beküldési kérelmet a Store-ból.
frissít Frissíti a meglévő repülési vázlatot a megadott JSON-val.
közzétesz Elindítja a meglévő piszkozat repülési beküldési folyamatát.
szavazás Mindaddig ismétlődő lekérdezéseket végez, amíg a meglévő járatbeküldés KÖZZÉ nem került vagy SIKERTELEN lett.
állapot Lekéri az áruház járatbeküldésének aktuális állapotát.
Bevezetés A repülési bevezetéssel kapcsolatos műveletek végrehajtása.

Járatok – Beküldés – Lekérés – Használat

msstore flights submission get <productId> <flightId>

Érvek

érvelés Leírás
productId A termékazonosító.
flightId A járatazonosító.

Beállítások

Lehetőség Leírás
-v, --részletes Részletes kimenet megjelenítése.
-?, -h, --help Súgó- és használati adatok megjelenítése.

Járatok – Beküldés – Törlés – Használat

msstore flights submission delete <productId> <flightId>

Érvek

érvelés Leírás
productId A termékazonosító.
flightId A járatazonosító.

Beállítások

Lehetőség Leírás
--nincs-megerősítés Ne kérje a megerősítést.
-v, --részletes Részletes kimenet megjelenítése.
-?, -h, --help Súgó- és használati adatok megjelenítése.

Járatok – Beküldés – Frissítés – Használat

msstore flights submission update <productId> <flightId> <product>

Érvek

érvelés Leírás
productId A termékazonosító.
flightId A járatazonosító.
product A frissített JSON-termékábrázolás.

Beállítások

Lehetőség Leírás
-s, --skipInitialPolling (kezdeti lekérdezés kihagyása) A művelet végrehajtása előtt hagyja ki a kezdeti lekérdezést. [alapértelmezett: Hamis]
-v, --részletes Részletes kimenet megjelenítése.
-?, -h, --help Súgó- és használati adatok megjelenítése.

Járatok – Beküldés – Közzététel – Használat

msstore flights publish <productId> <flightId>

Érvek

érvelés Leírás
productId A termékazonosító.
flightId A járatazonosító.

Beállítások

Lehetőség Leírás
-v, --részletes Részletes kimenet megjelenítése.
-?, -h, --help Súgó- és használati adatok megjelenítése.

Járatok – Beküldés – Szavazás – Használat

msstore flights poll <productId> <flightId>

Érvek

érvelés Leírás
productId A termékazonosító.
flightId A járatazonosító.

Beállítások

Lehetőség Leírás
-v, --részletes Részletes kimenet megjelenítése.
-?, -h, --help Súgó- és használati adatok megjelenítése.

Járatok – Beküldés – Állapot – Használat

msstore flights status <productId> <flightId>

Érvek

érvelés Leírás
productId A termékazonosító.
flightId A járatazonosító.

Beállítások

Lehetőség Leírás
-v, --részletes Részletes kimenet megjelenítése.
-?, -h, --help Súgó- és használati adatok megjelenítése.

Járatok – Beküldés – Bevezetés

Sub-Command Leírás
kap Lekéri egy beküldés repülési bevezetési állapotát.
frissít Frissítse a beküldések repülési bevezetési százalékos arányát.
Megállás A beküldés repülési bevezetésének leállítása.
Véglegesítse Véglegesíti a beküldés repülési bevezetésének véglegesítését.

Járatok – Benyújtás – Bevezetés – Lekérdezés – Használat

msstore flights submission rollout get <productId> <flightId>

Érvek

érvelés Leírás
productId A termékazonosító.
flightId A járatazonosító.

Beállítások

Lehetőség Leírás
-s, --beküldésiAzonosító A beküldés azonosítója.
-v, --részletes Részletes kimenet megjelenítése.
-?, -h, --help Súgó- és használati adatok megjelenítése.

Járatok – Beküldés – Bevezetés – Frissítés – Használat

msstore flights submission rollout update <productId> <flightId> <percentage>

Érvek

érvelés Leírás
productId A termékazonosító.
flightId A járatazonosító.
percentage A beküldés bevezetését fogadó felhasználók százalékos aránya.

Beállítások

Lehetőség Leírás
-s, --beküldésiAzonosító A beküldés azonosítója.
-v, --részletes Részletes kimenet megjelenítése.
-?, -h, --help Súgó- és használati adatok megjelenítése.

Járatok – Beküldés – Bevezetés – Leállítás – Használat

msstore flights submission rollout halt <productId> <flightId>

Érvek

érvelés Leírás
productId A termékazonosító.
flightId A járatazonosító.

Beállítások

Lehetőség Leírás
-s, --beküldésiAzonosító A beküldés azonosítója.
-v, --részletes Részletes kimenet megjelenítése.
-?, -h, --help Súgó- és használati adatok megjelenítése.

Járatok – Beküldés – Bevezetés – Véglegesítés – Használat

msstore flights submission rollout finalize <productId> <flightId>

Érvek

érvelés Leírás
productId A termékazonosító.
flightId A járatazonosító.

Beállítások

Lehetőség Leírás
-s, --beküldésiAzonosító A beküldés azonosítója.
-v, --részletes Részletes kimenet megjelenítése.
-?, -h, --help Súgó- és használati adatok megjelenítése.

CI/CD-környezetek

A Microsoft Store fejlesztői parancssori felület (előzetes verzió) támogatja a CI/CD-környezetekben való futtatásokat. Ez azt jelenti, hogy a CI/CD folyamatokban a Microsoft Store Fejlesztői CLI (előzetes verzió) használatával például automatikusan publikálhatja alkalmazásait a Microsoft Store-ban.

Ennek első lépéseként telepítse a Microsoft Store fejlesztői parancssori felületet (előzetes verzió) a CI/CD-környezetben. Erről itt talál útmutatást.

A Microsoft Store fejlesztői parancssori felület (előzetes verzió) telepítése után konfigurálnia kell a környezetet a parancsok futtatására. Ehhez futtassa a parancsot a msstore reconfigure partnerközpont fiókját azonosító paraméterekkel (TenantId, SellerId, ClientId). Meg kell adnia egy ClientSecret vagy egy tanúsítványt is.

Nagyon fontos, hogy elrejtse ezeket a hitelesítő adatokat, mivel azok láthatók lesznek a CI/CD-folyamat naplóiban. Ezt titkos kódok használatával teheti meg. Mindegyik CI/CD-folyamatrendszernek különböző nevei vannak ezekhez a titkos kódokhoz. Például az Azure DevOps titkos változóknak nevezi őket, de a GitHub Action titkosított titkoknak hívja őket. Hozzon létre egy titkos kulcsot az egyes paraméterekhez (TenantId, SellerId, ClientId és ClientSecretvagy tanúsítvány), majd a reconfigure paranccsal állítsa be a környezetet.

Például:

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

A parancs végrehajtása után a Microsoft Store fejlesztői parancssori felület (előzetes verzió) a megadott hitelesítő adatok használatára lesz konfigurálva. Most már használhatja a Microsoft Store fejlesztői parancssori felületet (előzetes verzió) a CI/CD-folyamatban.