Befehle (MSIX)

Einrichtung

Schritt 1: Installieren von .NET Windows Runtime

Falls noch nicht geschehen, installieren Sie die neueste Version der .NET 9 Desktop Runtime. Dies ist notwendig, damit Microsoft Store Developer CLI ausgeführt werden kann.

Die einfachste Möglichkeit der Installation ist die Verwendung von winget:

winget install Microsoft.DotNet.DesktopRuntime.9

Schritt 2: Installieren der Microsoft Store Developer CLI unter Windows

Sie können Microsoft Store Developer CLI aus Microsoft Store herunterladen. Alternativ können Sie auch winget verwenden:

winget install "Microsoft Store Developer CLI"

Schritt 1: Installieren von .NET macOS Runtime

Falls noch nicht geschehen, installieren Sie die neueste Version der .NET 9-Runtime. Dies ist notwendig, damit Microsoft Store Developer CLI ausgeführt werden kann.

Schritt 2: Installieren der Microsoft Store Developer CLI unter macOS

Sie können die macOS .tar.gz für Ihre spezifische Architektur (x64 oder Arm64) von der Microsoft Store Developer CLI-Veröffentlichungsseite herunterladen. Extrahieren Sie nach dem erfolgreichen Download das Archiv und fügen Sie es nach Belieben in Ihren PFAD ein, z. B.:

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

Alternativ können Sie auch brew verwenden:

brew install microsoft/msstore-cli/msstore-cli

Schritt 1: Installieren von .NET Linux Runtime

Falls noch nicht geschehen, installieren Sie die neueste Version der .NET 9-Runtime. Dies ist notwendig, damit Microsoft Store Developer CLI ausgeführt werden kann.

Schritt 2: Installieren der Microsoft Store Developer CLI unter Linux

Sie können die .tar.gz für Linux für Ihre spezifische Architektur (x64 oder Arm64) von der Microsoft Store Developer CLI-Veröffentlichungsseite herunterladen. Extrahieren Sie nach dem erfolgreichen Download das Archiv und fügen Sie es nach Belieben in Ihren PFAD ein, z. B.:

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

Alternativ können Sie auch brew verwenden:

brew install microsoft/msstore-cli/msstore-cli

Befehl „Info“

Vorhandene Konfiguration drucken.

Usage

msstore info

Options

Auswahlmöglichkeit	Beschreibung
-v, --ausführlich	Ausführliche Ausgabe drucken.
-?, -h, --help	Zeigen Sie Hilfe- und Nutzungsinformationen an.

Befehl „reconfigure“

Konfigurieren Sie die Microsoft Store Developer CLI erneut. Sie können entweder einen geheimen Clientschlüssel oder ein Zertifikat angeben. Zertifikate können entweder über den Fingerabdruck oder durch Bereitstellen eines Dateipfads (mit oder ohne Kennwort) bereitgestellt werden.

Usage

msstore reconfigure

Options

Auswahlmöglichkeit	Beschreibung
-t, --mandantenID	Geben Sie die Mandanten-ID an, die verwendet werden soll.
-s, --sellerId (Verkäufer-ID)	Geben Sie die Verkäufer-ID an, die verwendet werden soll.
-c, --clientId	Geben Sie die Client-ID an, die verwendet werden soll.
-cs, --clientSecret	Geben Sie den geheimen Clientschlüssel an, der verwendet werden soll.
-ct, --certificateFingerabdruck	Geben Sie den Zertifikatfingerabdruck an, der verwendet werden soll.
-cfp, --certificateFilePath	Geben Sie den Zertifikatdateipfad an, der verwendet werden soll.
-cp, --zertifikatsPasswort	Geben Sie das Zertifikatkennwort an, das verwendet werden soll.
--zurücksetzen	Setzen Sie die Anmeldeinformationen nur zurück, ohne zu beginnen.
-v, --ausführlich	Ausführliche Ausgabe drucken.
-?, -h, --help	Zeigen Sie Hilfe- und Nutzungsinformationen an.

Settings-Befehl

Ändern Sie die Einstellungen der Microsoft Store Developer CLI.

Usage

msstore settings

Options

Auswahlmöglichkeit	Beschreibung
-t, --enableTelemetry (Telemetrie aktivieren)	Aktivieren (leer/true) oder Deaktivieren (false) Telemetrie.
-v, --ausführlich	Ausführliche Ausgabe drucken.
-?, -h, --help	Zeigen Sie Hilfe- und Nutzungsinformationen an.

SetPDN-Sub-Command

Legen Sie die Publisher-Anzeigename-Eigenschaft fest, die vom Init-Befehl verwendet wird.

Usage

msstore settings setpdn <publisherDisplayName>

Argumente

Streitpunkt	Beschreibung
publisherDisplayName	Die Publisher-Anzeigename-Eigenschaft, die global festgelegt wird.

Options

Auswahlmöglichkeit	Beschreibung
-?, -h, --help	Zeigen Sie Hilfe- und Nutzungsinformationen an.

Befehl „apps“

Unterbefehl	Beschreibung
liste	Listet alle Anwendungen in Ihrem Konto auf.
Erhalten	Ruft die Details einer bestimmten Anwendung ab.

Apps – Liste – Verwendung

msstore apps list

Options

Auswahlmöglichkeit	Beschreibung
-v, --ausführlich	Ausführliche Ausgabe drucken.
-?, -h, --help	Zeigen Sie Hilfe- und Nutzungsinformationen an.

Apps – Abrufen – Nutzung

msstore apps get <productId>

Argumente

Streitpunkt	Beschreibung
productId	Die Store-Produkt-ID.

Options

Auswahlmöglichkeit	Beschreibung
-v, --ausführlich	Ausführliche Ausgabe drucken.
-?, -h, --help	Zeigen Sie Hilfe- und Nutzungsinformationen an.

Befehl „submission“

Unterbefehl	Beschreibung
Status	Ruft den Status einer Übermittlung ab.
Erhalten	Ruft die Metadaten und Paketinformationen einer bestimmten Übermittlung ab.
getListingAssets	Ruft die Auflistungsressourcen einer bestimmten Übermittlung ab.
MetadatenAktualisieren	Aktualisiert die Metadaten einer bestimmten Übermittlung.
Umfrage	Fragt den Status einer Übermittlung ab.
Veröffentlichen	Veröffentlicht eine bestimmte Übermittlung.
Löschen	Löscht eine bestimmte Übermittlung.

Übermittlung - Status - Verwendung

msstore submission status <productId>

Argumente

Streitpunkt	Beschreibung
productId	Die Store-Produkt-ID.

Options

Auswahlmöglichkeit	Beschreibung
-v, --ausführlich	Ausführliche Ausgabe drucken.
-?, -h, --help	Zeigen Sie Hilfe- und Nutzungsinformationen an.

Übermittlung – Abrufen – Verwendung

msstore submission get <productId>

Argumente

Streitpunkt	Beschreibung
productId	Die Store-Produkt-ID.

Options

Auswahlmöglichkeit	Beschreibung
-v, --ausführlich	Ausführliche Ausgabe drucken.
-?, -h, --help	Zeigen Sie Hilfe- und Nutzungsinformationen an.

Übermittlung - GetListingAssets – Verwendung

msstore submission getListingAssets <productId>

Argumente

Streitpunkt	Beschreibung
productId	Die Store-Produkt-ID.

Options

Auswahlmöglichkeit	Beschreibung
-v, --ausführlich	Ausführliche Ausgabe drucken.
-?, -h, --help	Zeigen Sie Hilfe- und Nutzungsinformationen an.

Übermittlung - UpdateMetadata – Verwendung

msstore submission updateMetadata <productId> <metadata>

Argumente

Streitpunkt	Beschreibung
productId	Die Store-Produkt-ID.
metadata	Die aktualisierte JSON-Metadatendarstellung.

Options

Auswahlmöglichkeit	Beschreibung
-s, --skipInitialPolling (Anfängliche Abfrage überspringen)	Überspringen Sie die anfängliche Abfrage, bevor Sie die Aktion ausführen. [Standard: False]
-v, --ausführlich	Ausführliche Ausgabe drucken.
-?, -h, --help	Zeigen Sie Hilfe- und Nutzungsinformationen an.

Übermittlung - Umfrage - Nutzung

msstore submission poll <productId>

Argumente

Streitpunkt	Beschreibung
productId	Die Store-Produkt-ID.

Options

Auswahlmöglichkeit	Beschreibung
-v, --ausführlich	Ausführliche Ausgabe drucken.
-?, -h, --help (Hilfe)	Zeigen Sie Hilfe- und Nutzungsinformationen an.

Übermittlung - Veröffentlichen – Verwendung

msstore submission publish <productId>

Argumente

Streitpunkt	Beschreibung
productId	Die Store-Produkt-ID.

Options

Auswahlmöglichkeit	Beschreibung
-v, --ausführlich	Ausführliche Ausgabe drucken.
-?, -h, --help	Zeigen Sie Hilfe- und Nutzungsinformationen an.

Übermittlung - Löschen – Verwendung

msstore submission delete <productId>

Argumente

Streitpunkt	Beschreibung
productId	Die Store-Produkt-ID.

Options

Auswahlmöglichkeit	Beschreibung
--no-confirm	Nicht zur Bestätigung auffordern [Standard: False]
-v, --ausführlich	Ausführliche Ausgabe drucken.
-?, -h, --help	Zeigen Sie Hilfe- und Nutzungsinformationen an.

Flugbefehl

Unterbefehl	Beschreibung
liste	Ruft alle Flights für die angegebene Anwendung ab.
Erhalten	Ruft einen Flug für die angegebene Anwendung und den angegebenen Flug ab.
Löschen	Löscht einen Flight für die angegebene Anwendung und den angegebenen Flight.
create	Erstellt einen Flight für die angegebene Anwendung und den angegebenen Flight.
Unterwerfung	Aufgaben im Zusammenhang mit der Abgabe von Flugeinreichungen ausführen.

Flights – Befehlsverwendung für Listen

msstore flights list <productId>

Flüge – Befehlsargumente für Listen

Streitpunkt	Beschreibung
productId	Die Produkt-ID.

Flights – Hilfe zu Listenbefehlen

msstore flights list --help

Flights – Verwendung von Befehlen

msstore flights get <productId> <flightId>

Flights – Befehlsargumente abrufen

Streitpunkt	Beschreibung
productId	Die Produkt-ID.
flightId	Die Flight-ID.

Flüge – Befehlshilfe abrufen

msstore flights get --help

Flights – Löschen der Befehlsverwendung

msstore flights delete <productId> <flightId>

Flights – Löschen von Befehlsargumenten

Streitpunkt	Beschreibung
productId	Die Produkt-ID.
flightId	Die Flight-ID.

Flights – Befehlshilfe löschen

msstore flights delete --help

Flights – Erstellen der Befehlsverwendung

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

Flüge – Erstellen von Befehlsargumenten

Streitpunkt	Beschreibung
productId	Die Produkt-ID.
friendlyName	Der benutzerfreundliche Name des Fluges.

Flüge – Befehlsoptionen erstellen

Auswahlmöglichkeit	Beschreibung
-g, --group-ids	Die Gruppen-IDs, die dem Test-Flight zugeordnet werden sollen.
-r, --rank-higher-than (Rang höher als)	Die Flight-ID, die höher eingestuft wird als.

Flights – Befehlshilfe erstellen

msstore flights create --help

Flights – Einsendebefehl

Unterbefehl	Beschreibung
Erhalten	Ruft den vorhandenen Flug-Paketübermittlungsvorgang ab, entweder den bestehenden Entwurf oder die zuletzt veröffentlichte.
Löschen	Löscht die ausstehende Paketeinreichung aus dem Store.
aktualisieren	Aktualisiert den vorhandenen Flug-Entwurf mit dem bereitgestellten JSON.
Veröffentlichen	Startet den Übermittlungsprozess für den vorhandenen Entwurf.
Umfrage	Überwacht, bis die vorhandene Flight-Übermittlung veröffentlicht oder fehlgeschlagen ist.
Status	Ruft den aktuellen Status der Store-Flight-Übermittlung ab.
Rollout	Flugbetriebsbezogene Rollout-Vorgänge ausführen.

Flights – Übermittlungsbefehlsverwendung abrufen

msstore flights submission get <productId> <flightId>

Flights – Argumente des Eingabebefehls abrufen

Streitpunkt	Beschreibung
productId	Die Produkt-ID.
flightId	Die Flight-ID.

Flights – Übermittlungsbefehl – Hilfe zum Abrufen von Befehlen

msstore flights submission get --help

Flights – Verwendung des Befehls "Übermittlung löschen"

msstore flights submission delete <productId> <flightId>

Flights – Übermittlungsbefehlsargumente löschen

Streitpunkt	Beschreibung
productId	Die Produkt-ID.
flightId	Die Flight-ID.

Flights – Hilfe zur Eingabebefehl Löschung

msstore flights submission delete --help

Flights – Übermittlungsaktualisierungsbefehlsverwendung

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

Flights – Befehlsargumente zur Aktualisierung von Einsendungen

Streitpunkt	Beschreibung
productId	Die Produkt-ID.
flightId	Die Flight-ID.
product	Die aktualisierte JSON-Produktdarstellung.

Flüge – Befehlsoptionen für Einreichungsupdates

Auswahlmöglichkeit	Beschreibung
-s, --skipInitialPolling (Anfängliche Abfrage überspringen)	Überspringen Sie die anfängliche Abfrage, bevor Sie die Aktion ausführen. [Standard: False]

Flights – Befehls-Hilfe für Übermittlungsupdate

msstore flights submission update --help

Flights – Verwendung des Befehls "Übermittlung veröffentlichen"

msstore flights submission publish <productId> <flightId>

Flights – Übermittlungsbefehlsargumente veröffentlichen

Streitpunkt	Beschreibung
productId	Die Produkt-ID.
flightId	Die Flight-ID.

Flights – Hilfe zu Veröffentlichungsbefehl für Einsendungen

msstore flights submission publish --help

Flights – Übermittlungsumfrage– Verwendung des Befehls "Übermittlungsumfrage"

msstore flights submission poll <productId> <flightId>

Flights – Befehlsargumente für Übermittlungsumfragen

Streitpunkt	Beschreibung
productId	Die Produkt-ID.
flightId	Die Flight-ID.

Flüge – Hilfe zum Befehl 'Übermittlungsumfrage'

msstore flights submission poll --help

Flüge – Verwendung des Übermittlungsstatusbefehls

msstore flights submission status <productId> <flightId>

Flights – Übermittlungsstatus-Befehlsargumente

Streitpunkt	Beschreibung
productId	Die Produkt-ID.
flightId	Die Flight-ID.

Flights – Hilfe zum Übermittlungsstatus-Befehl

msstore flights submission status --help

Flüge - Übermittlung – Rollout-Befehl

Unterbefehl	Beschreibung
Erhalten	Ruft den Flight-Rolloutstatus einer Übermittlung ab.
aktualisieren	Aktualisieren Sie den Prozentsatz des Flug-Rollouts einer Einsendung.
anhalten	Hält das Flight-Rollout einer Übermittlung an.
Finalize	Schließt das Flight-Rollout einer Einreichung ab.

Flights – Übertragung – Rollout-Verwendung von Get-Befehlen

msstore flights submission rollout get <productId> <flightId>

Flights - Übermittlung - Rollout Abrufen von Befehlsargumenten

Streitpunkt	Beschreibung
productId	Die Produkt-ID.
flightId	Die Flight-ID.

Flights - Einreichung - Rollout Get Command Optionen

Auswahlmöglichkeit	Beschreibung
-s, --submissionId	Die Übermittlungs-ID.

Flights – Übermittlung – Abrufen der Befehlshilfe für Rollout

msstore flights submission rollout get --help

Flights – Übermittlung – Rollout-Updatebefehlsverwendung

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

Flights - Einreichung - Rollout-Update-Befehlsargumente

Streitpunkt	Beschreibung
productId	Die Produkt-ID.
flightId	Die Flight-ID.
percentage	Der Prozentsatz der Benutzer, die den Übermittlungsrollout erhalten.

Flights – Übermittlung – Rollout-Updatebefehlsoptionen

Auswahlmöglichkeit	Beschreibung
-s, --submissionId	Die Übermittlungs-ID.

Flüge – Übermittlung – Update-Rollout-Hilfe

msstore flights submission rollout update --help

Flights – Übermittlung – Verwendung des Befehls zur Unterbrechung des Rollouts

msstore flights submission rollout halt <productId> <flightId>

Flights - Einreichung - Rollout-Stoppbefehl Argumente

Streitpunkt	Beschreibung
productId	Die Produkt-ID.
flightId	Die Flight-ID.

Flüge – Übermittlung – Rollout-Optionen für den Befehl zum Anhalten

Auswahlmöglichkeit	Beschreibung
-s, --submissionId	Die Übermittlungs-ID.

Flights – Einreichung – Hilfe zum Befehl zum Stoppen des Rollouts

msstore flights submission rollout halt --help

Flights – Übermittlung – Rollout Befehlsverwendung Finalisieren

msstore flights submission rollout finalize <productId> <flightId>

Flights - Übermittlung – Rollout abschließen Befehlsargumente

Streitpunkt	Beschreibung
productId	Die Produkt-ID.
flightId	Die Flight-ID.

Flights - Übertragung – Rollout abschließen Befehlsoptionen

Auswahlmöglichkeit	Beschreibung
-s, --submissionId	Die Übermittlungs-ID.

Flights – Übermittlung – Rollout finalisieren Befehlsanleitung

msstore flights submission rollout finalize --help

Befehl „init“

Mit init dem Befehl können Sie Ihre Anwendung so einrichten, dass sie im Microsoft Store veröffentlicht wird. Es unterstützt derzeit die folgenden Anwendungstypen:

• Windows App SDK/WinUI 3
• UWP (Universelle Windows-Plattform)
• .NET MAUI
• Flattern
• Elektron
• React Native für Desktop
• PWA

Verwendungsbeispiele

Windows App SDK/WinUI 3

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

UWP (Universelle Windows-Plattform)

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

.NET MAUI

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

Flattern

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

Elektron

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

React Native für Desktop

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

Hinweis

Sowohl für Electron als auch React Native for Desktop-Projekte werden Npm beide Yarn unterstützt. Das Vorhandensein der Yarn Sperrdatei (yarn.lock) wird verwendet, um zu bestimmen, welcher Paket-Manager verwendet werden soll. Stellen Sie daher sicher, dass Sie die Sperrdatei in Ihrem Quellcodeverwaltungssystem einchecken.

PWA

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

Argumente

Streitpunkt	Beschreibung
pathOrUrl	Der Stammverzeichnispfad, in dem sich die Projektdatei befindet, oder eine öffentliche URL, die auf eine PWA verweist.

Options

Auswahlmöglichkeit	Beschreibung
-n, --publisherDisplayName (Name des Herausgebers anzeigen)	Der Publisher-Anzeigename, der zum Konfigurieren der Anwendung verwendet wird. Wenn angegeben, vermeiden Sie einen zusätzlichen APIs-Aufruf.
--Paket	Wenn der App-Typ unterstützt wird, packt das Projekt automatisch.
--veröffentlichen	Wenn der App-Typ unterstützt wird, veröffentlicht das Projekt automatisch. Impliziert "--package true"
-f, --flugId	Gibt die Flight-ID an, in der das Paket veröffentlicht wird.
-prp, --packageRolloutProzentsatz	Gibt den Rollout-Prozentsatz des Pakets an. Der Wert muss zwischen 0 und 100 liegen.
-a, --arch	Die zu erstellenden Architekturen. Wenn nicht angegeben, wird die Standardarchitektur für das aktuelle Betriebssystem und den Projekttyp verwendet. Zulässige Werte: "x86", "x64", "arm64". Wird nur in Verbindung mit "--package true" verwendet.
-o, --Ausgabe	Das Ausgabeverzeichnis, in dem die verpackte App gespeichert wird. Wenn nicht angegeben, wird das Standardverzeichnis für jeden anderen App-Typ verwendet.
-ver, --version	Die Version, die beim Erstellen der App verwendet wird. Wenn nicht angegeben, wird die Version aus der Projektdatei verwendet.

Befehl „package“

Hilft Ihnen, Ihre Microsoft Store-Anwendung als MSIX zu verpacken.

Verwendungsbeispiele

Windows App SDK/WinUI 3

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

UWP (Universelle Windows-Plattform)

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

.NET MAUI

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

Flattern

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

Elektron

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

React Native für Desktop

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

PWA

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

Argumente

Auswahlmöglichkeit	Beschreibung
pathOrUrl	Der Stammverzeichnispfad, in dem sich die Projektdatei befindet, oder eine öffentliche URL, die auf eine PWA verweist.

Options

Auswahlmöglichkeit	Beschreibung
-o, --Ausgabe	Das Ausgabeverzeichnis, in dem die verpackte App gespeichert wird. Wenn nicht angegeben, wird das Standardverzeichnis für jeden anderen App-Typ verwendet.
-a, --arch	Die zu erstellenden Architekturen. Wenn nicht angegeben, wird die Standardarchitektur für das aktuelle Betriebssystem und den Projekttyp verwendet. Zulässige Werte: "x86", "x64", "arm64".
-ver, --version	Die Version, die beim Erstellen der App verwendet wird. Wenn nicht angegeben, wird die Version aus der Projektdatei verwendet.

Befehl „Publish“

Veröffentlicht Ihre Anwendungen im Microsoft Store.

Verwendungsbeispiele

Windows App SDK/WinUI 3

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

UWP (Universelle Windows-Plattform)

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

.NET MAUI

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

Flattern

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

Elektron

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

React Native für Desktop

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

PWA

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

Argumente

Auswahlmöglichkeit	Beschreibung
pathOrUrl	Der Stammverzeichnispfad, in dem sich die Projektdatei befindet, oder eine öffentliche URL, die auf eine PWA verweist.

Options

Auswahlmöglichkeit	Beschreibung
-i, --Eingabedatei	Der Pfad zur Datei ".msix" oder ".msixupload", die für den Veröffentlichungsbefehl verwendet werden soll. Wenn nicht angegeben, versucht die CLI die beste Option auf Basis des Arguments „pathOrUrl“ zu finden.
-id, --appId (Anwendungs-ID)	Gibt die Anwendungs-ID an. Nur erforderlich, wenn das Projekt noch nicht mit dem Befehl „init“ initialisiert wurde.
-nc, --noCommit	Deaktiviert das Commit für die Übermittlung und behält sie im Entwurfszustand bei.
-f, --flugId	Gibt die Flight-ID an, in der das Paket veröffentlicht wird.
-prp, --packageRolloutProzentsatz	Gibt den Rollout-Prozentsatz des Pakets an. Der Wert muss zwischen 0 und 100 liegen.

Flugbefehl

Unterbefehl	Beschreibung
liste	Ruft alle Flights für die angegebene Anwendung ab.
Erhalten	Ruft einen Flug für die angegebene Anwendung und den angegebenen Flug ab.
Löschen	Löscht einen Flight für die angegebene Anwendung und den angegebenen Flight.
create	Erstellt einen Flight für die angegebene Anwendung und den angegebenen Flight.
Unterwerfung	Aufgaben im Zusammenhang mit der Abgabe von Flugeinreichungen ausführen.

Flüge - Liste - Nutzung

msstore flights list <productId>

Argumente

Streitpunkt	Beschreibung
productId	Die Produkt-ID.

Options

Auswahlmöglichkeit	Beschreibung
-v, --ausführlich	Ausführliche Ausgabe drucken.
-?, -h, --help	Zeigen Sie Hilfe- und Nutzungsinformationen an.

Flights - Get - Usage

msstore flights get <productId> <flightId>

Argumente

Streitpunkt	Beschreibung
productId	Die Produkt-ID.
flightId	Die Flight-ID.

Options

Auswahlmöglichkeit	Beschreibung
-v, --ausführlich	Ausführliche Ausgabe drucken.
-?, -h, --help	Zeigen Sie Hilfe- und Nutzungsinformationen an.

Flüge - Löschen – Nutzung

msstore flights delete <productId> <flightId>

Argumente

Streitpunkt	Beschreibung
productId	Die Produkt-ID.
flightId	Die Flight-ID.

Options

Auswahlmöglichkeit	Beschreibung
-v, --ausführlich	Ausführliche Ausgabe drucken.
-?, -h, --help	Zeigen Sie Hilfe- und Nutzungsinformationen an.

Flüge - Erstellen - Nutzung

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

Argumente

Streitpunkt	Beschreibung
productId	Die Produkt-ID.
friendlyName	Der benutzerfreundliche Name des Fluges.

Options

Auswahlmöglichkeit	Beschreibung
-g, --group-ids	Die Gruppen-IDs, die dem Test-Flight zugeordnet werden sollen.
-r, --rank-higher-than (Rang höher als)	Die Flight-ID, die höher eingestuft wird als.
-v, --ausführlich	Ausführliche Ausgabe drucken.
-?, -h, --help	Zeigen Sie Hilfe- und Nutzungsinformationen an.

Flights – Einreichung

Unterbefehl	Beschreibung
Erhalten	Ruft den vorhandenen Flug-Paketübermittlungsvorgang ab, entweder den bestehenden Entwurf oder die zuletzt veröffentlichte.
Löschen	Löscht die ausstehende Paketeinreichung aus dem Store.
aktualisieren	Aktualisiert den vorhandenen Flug-Entwurf mit dem bereitgestellten JSON.
Veröffentlichen	Startet den Übermittlungsprozess für den vorhandenen Entwurf.
Umfrage	Überwacht, bis die vorhandene Flight-Übermittlung veröffentlicht oder fehlgeschlagen ist.
Status	Ruft den aktuellen Status der Store-Flight-Übermittlung ab.
Rollout	Flugbetriebsbezogene Rollout-Vorgänge ausführen.

Flüge - Einsendung - Abrufen - Nutzung

msstore flights submission get <productId> <flightId>

Argumente

Streitpunkt	Beschreibung
productId	Die Produkt-ID.
flightId	Die Flight-ID.

Options

Auswahlmöglichkeit	Beschreibung
-v, --ausführlich	Ausführliche Ausgabe drucken.
-?, -h, --help	Zeigen Sie Hilfe- und Nutzungsinformationen an.

Flights - Übermittlung - Löschen - Nutzung

msstore flights submission delete <productId> <flightId>

Argumente

Streitpunkt	Beschreibung
productId	Die Produkt-ID.
flightId	Die Flight-ID.

Options

Auswahlmöglichkeit	Beschreibung
--no-confirm	Nicht zur Bestätigung auffordern
-v, --ausführlich	Ausführliche Ausgabe drucken.
-?, -h, --help	Zeigen Sie Hilfe- und Nutzungsinformationen an.

Flights - Einreichung - Aktualisierung - Nutzung

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

Argumente

Streitpunkt	Beschreibung
productId	Die Produkt-ID.
flightId	Die Flight-ID.
product	Die aktualisierte JSON-Produktdarstellung.

Options

Auswahlmöglichkeit	Beschreibung
-s, --skipInitialPolling (Anfängliche Abfrage überspringen)	Überspringen Sie die anfängliche Abfrage, bevor Sie die Aktion ausführen. [Standard: False]
-v, --ausführlich	Ausführliche Ausgabe drucken.
-?, -h, --help	Zeigen Sie Hilfe- und Nutzungsinformationen an.

Flüge - Einreichung - Veröffentlichung - Nutzung

msstore flights publish <productId> <flightId>

Argumente

Streitpunkt	Beschreibung
productId	Die Produkt-ID.
flightId	Die Flight-ID.

Options

Auswahlmöglichkeit	Beschreibung
-v, --ausführlich	Ausführliche Ausgabe drucken.
-?, -h, --help	Zeigen Sie Hilfe- und Nutzungsinformationen an.

Flüge - Übermittlung - Umfrage - Nutzung

msstore flights poll <productId> <flightId>

Argumente

Streitpunkt	Beschreibung
productId	Die Produkt-ID.
flightId	Die Flight-ID.

Options

Auswahlmöglichkeit	Beschreibung
-v, --ausführlich	Ausführliche Ausgabe drucken.
-?, -h, --help	Zeigen Sie Hilfe- und Nutzungsinformationen an.

Flights - Übermittlung - Status - Nutzung

msstore flights status <productId> <flightId>

Argumente

Streitpunkt	Beschreibung
productId	Die Produkt-ID.
flightId	Die Flight-ID.

Options

Auswahlmöglichkeit	Beschreibung
-v, --ausführlich	Ausführliche Ausgabe drucken.
-?, -h, --help	Zeigen Sie Hilfe- und Nutzungsinformationen an.

Flights - Einreichung - Rollout

Unterbefehl	Beschreibung
Erhalten	Ruft den Flight-Rolloutstatus einer Übermittlung ab.
aktualisieren	Aktualisieren Sie den Prozentsatz des Flug-Rollouts einer Einsendung.
anhalten	Hält das Flight-Rollout einer Übermittlung an.
Finalize	Schließt das Flight-Rollout einer Einreichung ab.

Flüge - Einreichung - Einführung - Erhalten - Nutzung

msstore flights submission rollout get <productId> <flightId>

Argumente

Streitpunkt	Beschreibung
productId	Die Produkt-ID.
flightId	Die Flight-ID.

Options

Auswahlmöglichkeit	Beschreibung
-s, --Einreichungs-ID	Die Übermittlungs-ID.
-v, --ausführlich	Ausführliche Ausgabe drucken.
-?, -h, --help	Zeigen Sie Hilfe- und Nutzungsinformationen an.

Flights - Übermittlung - Rollout - Update - Nutzung

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

Argumente

Streitpunkt	Beschreibung
productId	Die Produkt-ID.
flightId	Die Flight-ID.
percentage	Der Prozentsatz der Benutzer, die den Übermittlungsrollout erhalten.

Options

Auswahlmöglichkeit	Beschreibung
-s, --Einreichungs-ID	Die Übermittlungs-ID.
-v, --ausführlich	Ausführliche Ausgabe drucken.
-?, -h, --help	Zeigen Sie Hilfe- und Nutzungsinformationen an.

Flüge - Übermittlung - Rollout - Anhalten - Nutzung

msstore flights submission rollout halt <productId> <flightId>

Argumente

Streitpunkt	Beschreibung
productId	Die Produkt-ID.
flightId	Die Flight-ID.

Options

Auswahlmöglichkeit	Beschreibung
-s, --submissionId	Die Übermittlungs-ID.
-v, --ausführlich	Ausführliche Ausgabe drucken.
-?, -h, --help	Zeigen Sie Hilfe- und Nutzungsinformationen an.

Flüge - Übermittlung - Rollout - Abschließen - Nutzung

msstore flights submission rollout finalize <productId> <flightId>

Argumente

Streitpunkt	Beschreibung
productId	Die Produkt-ID.
flightId	Die Flight-ID.

Options

Auswahlmöglichkeit	Beschreibung
-s, --submissionId	Die Übermittlungs-ID.
-v, --ausführlich	Ausführliche Ausgabe drucken.
-?, -h, --help	Zeigen Sie Hilfe- und Nutzungsinformationen an.

CI/CD-Umgebungen

Die Microsoft Store Developer CLI (Vorschau) unterstützt die Ausführung in CI/CD-Umgebungen. Dies bedeutet, dass Sie die Microsoft Store Developer CLI (Vorschau) in Ihren CI/CD-Pipelines verwenden können, um beispielsweise Ihre Anwendungen automatisch im Microsoft Store zu veröffentlichen.

Der erste Schritt, um dies zu erreichen, um die Microsoft Store Developer CLI (Vorschau) in Ihrer CI/CD-Umgebung zu installieren. Anleitungen dazu finden Sie hier.

Nach der Installation der Microsoft Store Developer CLI (Vorschau) müssen Sie Ihre Umgebung so konfigurieren, dass Befehle ausgeführt werden können. Dazu können Sie den msstore reconfigure Befehl mit den spezifischen Parametern ausführen, die Ihr Partner Center-Konto (TenantId, SellerId, ClientId) identifizieren. Außerdem müssen Sie entweder einen ClientSecret oder ein Zertifikat angeben.

Es ist sehr wichtig, diese Anmeldeinformationen auszublenden, da sie in den Protokollen Ihrer CI/CD-Pipeline sichtbar sind. Dazu können Sie geheime Schlüssel verwenden. Jedes CI/CD-Pipelinesystem hat für diese geheimen Schlüssel unterschiedliche Namen. Beispielsweise rufen Azure DevOps sie geheime Variablen auf, aber GitHub Action ruft sie verschlüsselte Geheime Schlüssel auf. Erstellen Sie einen geheimen Schlüssel

Zum Beispiel:

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

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

Sobald dieser Befehl ausgeführt wird, wird die Microsoft Store Developer CLI (Vorschau) für die Verwendung der bereitgestellten Anmeldeinformationen konfiguriert. Sie können jetzt die Microsoft Store Developer CLI (Vorschau) in Ihrer CI/CD-Pipeline verwenden.