Freigeben über

Befehle (MSI/EXE)

Installation

Schritt 1: Installieren von .NET Windows-Runtime

Falls noch nicht geschehen, installieren Sie die neueste Version der .NET 8 Desktop Runtime. Dies ist eine Anforderung zum Ausführen der Microsoft Store Developer CLI.

Die einfachste Möglichkeit zum Installieren ist die Verwendung von Winget:

winget install Microsoft.DotNet.DesktopRuntime.8

Schritt 2: Installieren der Microsoft Store Developer CLI unter Windows

Sie können die Microsoft Store Developer CLI aus dem Microsoft Store herunterladen. Alternativ können Sie 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 8-Runtime. Dies ist eine Anforderung zum Ausführen der Microsoft Store Developer CLI.

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. Nachdem Sie das Archiv heruntergeladen haben, extrahieren Sie es und fügen Sie es auf eine beliebige Weise zu Ihrem PATH hinzu, 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 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 8-Runtime. Dies ist eine Anforderung zum Ausführen der Microsoft Store Developer CLI.

Schritt 2: Installieren der Microsoft Store Developer CLI unter Linux

Sie können die Linux -.tar.gz für Ihre spezifische Architektur (x64 oder Arm64) von der Microsoft Store Developer CLI-Veröffentlichungsseite herunterladen. Nachdem Sie das Archiv heruntergeladen haben, extrahieren Sie es und fügen Sie es auf die Art und Weise, wie Sie das möchten, in Ihren PATH ein, zum Beispiel:

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 brew verwenden:

brew install microsoft/msstore-cli/msstore-cli

Infobefehl

Vorhandene Konfiguration drucken.

Usage

msstore info

Options

Option Description
-v, --ausführlich Ausführliche Ausgabe drucken.
-?, -h, --help Zeigen Sie Hilfe- und Nutzungsinformationen an.

Befehl neu konfigurieren

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

Option Description
-t, --tenantId (Mandanten-ID) Geben Sie die Mandanten-ID an, die verwendet werden soll.
-s, --sellerId 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, --ZertifikatFingerabdruck Geben Sie den Zertifikatfingerabdruck an, der verwendet werden soll.
-cfp, --certificateFilePath Geben Sie den Zertifikatdateipfad an, der verwendet werden soll.
-cp, --certificatePassword (Passwort für Zertifikat) Geben Sie das Zertifikatkennwort an, das verwendet werden soll.
--zurücksetzen Setzen Sie die Anmeldeinformationen zurück, ohne von vorne zu beginnen.
-v, --ausführlich Ausführliche Ausgabe drucken.
-?, -h, --help Zeigen Sie Hilfe- und Nutzungsinformationen an.

Befehl 'Einstellungen'

Ändern Sie die Einstellungen der Microsoft Store Developer CLI.

Usage

msstore settings

Options

Option Description
-t, --enableTelemetry 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.

Usage

msstore settings setpdn <publisherDisplayName>

Arguments

Argument Description
publisherDisplayName Die Publisher-Anzeigename-Eigenschaft, die global festgelegt wird.

Options

Option Description
-?, -h, --help Zeigen Sie Hilfe- und Nutzungsinformationen an.

Übermittlungsbefehl

Unterbefehl Description
Status Ruft den Status einer Übermittlung ab.
Erhalten Ruft die Metadaten und Paketinformationen einer bestimmten Übermittlung ab.
getListingAssets Ruft die Auflistungsobjekte einer bestimmten Einreichung ab.
updateMetadata Aktualisiert die Metadaten einer bestimmten Übermittlung.
update Aktualisiert die Paketinformationen einer bestimmten Übermittlung.
Umfrage Fragt den Status einer Einreichung ab.
publish Veröffentlicht eine bestimmte Einreichung.

Übermittlung - Status - Verwendung

msstore submission status <productId>

Arguments

Argument Description
productId Die Partnercenter-ID.

Options

Option Description
-v, --ausführlich Ausführliche Ausgabe drucken.
-?, -h, --help Zeigen Sie Hilfe- und Nutzungsinformationen an.

Übermittlung – Abrufen – Verwendung

msstore submission get <productId>

Arguments

Argument Description
productId Die Partnercenter-ID.

Options

Option Description
-l, --sprache Wählen Sie aus, welche Sprache Sie abrufen möchten. [Standard: en] [Voreinstellung: en]
-v, --ausführlich Ausführliche Ausgabe drucken.
-?, -h, --help Zeigen Sie Hilfe- und Nutzungsinformationen an.

Übermittlung - GetListingAssets – Verwendung

msstore submission getListingAssets <productId>

Arguments

Argument Description
productId Die Partnercenter-ID.

Options

Option Description
-l, --sprache Wählen Sie aus, welche Sprache Sie abrufen möchten. [standard: en]
-v, --ausführlich Ausführliche Ausgabe drucken.
-?, -h, --help Zeigen Sie Hilfe- und Nutzungsinformationen an.

Übermittlung - UpdateMetadata – Verwendung

msstore submission updateMetadata <productId> <metadata>

Arguments

Argument Description
productId Die Partnercenter-ID.
metadata Die aktualisierte JSON-Metadatendarstellung.

Options

Option Description
-s, --skipInitialPolling Überspringen Sie die anfängliche Abfrage, bevor Sie die Aktion ausführen. [Standardwert: falsch]
-v, --ausführlich Ausführliche Ausgabe drucken.
-?, -h, --help Zeigen Sie Hilfe- und Nutzungsinformationen an.

Übermittlung – Update – Verwendung

msstore submission update <productId> <package>

Arguments

Argument Description
productId Die Partnercenter-ID.
package Die aktualisierte JSON-Darstellung des App-Pakets.

Options

Option Description
-s, --skipInitialPolling (überspringt die anfängliche Abfrage) Ü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>

Arguments

Argument Description
productId Die Partnercenter-ID.

Options

Option Description
-v, --ausführlich Ausführliche Ausgabe drucken.
-?, -h, --help Zeigen Sie Hilfe- und Nutzungsinformationen an.

Übermittlung - Veröffentlichen – Verwendung

msstore submission publish <productId>

Arguments

Argument Description
productId Die Partnercenter-ID.

Options

Option Description
-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, besteht darin, die Microsoft Store Developer-CLI (Vorschau) in Ihrer CI/CD-Umgebung zu installieren. Hier finden Sie Anweisungen dazu.

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 zu verbergen, 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 nennt Azure DevOps sie geheime Variablen, aber GitHub Action bezeichnet sie als verschlüsselte Geheimnisse. Erstellen Sie einen geheimen Schlüssel für jeden Parameter (TenantId, SellerId, ClientId und ClientSecret oder ein Zertifikat), und verwenden Sie dann den reconfigure Befehl, um Ihre Umgebung einzurichten.

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.

  • Last updated on