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 auf 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 .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 .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) auf der Seite Microsoft Store Developer CLI-Releases 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
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 neu. 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 (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, --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 (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 Eigenschaft Publisher Anzeigename fest.

Usage

msstore settings setpdn <publisherDisplayName>

Arguments

Argument Description
publisherDisplayName Die Eigenschaft "Publisher-Anzeigename", 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] [Voreinstellung: 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 (Anfängliche Abfrage überspringen) Ü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 (Anfängliche Abfrage überspringen) Ü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.

Tipp

Verwenden Sie submission get, um die aktuelle Package-JSON abzurufen, bevor Sie submission update aufrufen. Dadurch wird sichergestellt, dass Sie mit der richtigen Struktur und den aktuellen Werten arbeiten. Beispiel in PowerShell:

# 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

Weitere Kontexte finden Sie unter Publish-App-Updates für Microsoft Store mit GitHub Actions.

Ü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, ist, 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 rufen Azure DevOps sie Secret Variables auf, aber GitHub Action ruft sie Encrypted Secrets auf. 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 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 }}

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

  • Last updated on