Kommandon (MSI/EXE)

Installation

Steg 1: Installera .NET Windows Runtime

Om du inte redan har gjort det installerar du den senaste versionen av .NET 8 Desktop Runtime. Detta är ett krav för att köra Microsoft Store Developer CLI.

Det enklaste sättet att installera det är att använda winget:

winget install Microsoft.DotNet.DesktopRuntime.8

Steg 2: Installera Microsoft Store Developer CLI på Windows

Du kan ladda ned Microsoft Store Developer CLI från Microsoft Store. Du kan också använda winget:

winget install "Microsoft Store Developer CLI"

Steg 1: Installera .NET macOS Runtime

Om du inte redan har gjort det installerar du den senaste versionen av .NET 8 Runtime. Detta är ett krav för att köra Microsoft Store Developer CLI.

Steg 2: Installera Microsoft Store Developer CLI på macOS

Du kan ladda ned macOS-.tar.gz för din specifika arkitektur (x64 eller Arm64) från utgåvesidan Microsoft Store Developer CLI. När du har laddat ned det, extrahera arkivet och placera det i din PATH på det sätt du vill göra det, till exempel:

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

Du kan också använda brew:

brew install microsoft/msstore-cli/msstore-cli

Steg 1: Installera .NET Linux Runtime

Om du inte redan har gjort det installerar du den senaste versionen av .NET 8 Runtime. Detta är ett krav för att köra Microsoft Store Developer CLI.

Steg 2: Installera Microsoft Store Developer CLI på Linux

Du kan ladda ned Linux-.tar.gz för din specifika arkitektur (x64 eller Arm64) från Microsoft Store Developer CLI-releassidan. När du har laddat ned det, extrahera arkivet och placera det i din PATH på det sätt du vill göra det, till exempel:

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

Du kan också använda brew:

brew install microsoft/msstore-cli/msstore-cli

Info-kommando

Skriv ut befintlig konfiguration.

Usage

msstore info

Options

Option Description
-v, --detaljerad Skriv ut utförliga utdata.
-?, -h, --hjälp (för hjälp) Visa hjälp- och användningsinformation.

Konfigurera om kommandot

Konfigurera om Microsoft Store Developer CLI. Du kan ange antingen en klienthemlighet eller ett certifikat. Certifikat kan tillhandahållas antingen via tumavtrycket eller genom att ange en filsökväg (med eller utan lösenord).

Usage

msstore reconfigure

Options

Option Description
-t, --hyresgästId Ange det klient-ID som ska användas.
-s, --sellerId Ange det säljar-ID som ska användas.
-c, --klientId Ange det klient-ID som ska användas.
-cs, --klienthemlighet Ange den klienthemlighet som ska användas.
-ct, --certifikatFingeravtryck Ange det tumavtryck för certifikatet som ska användas.
-cfp, --certificateFilePath Ange den certifikatfilsökväg som ska användas.
-cp, --certifikatlösenord Ange certifikatlösenordet som ska användas.
--återställ Återställ bara autentiseringsuppgifterna utan att starta om.
-v, --detaljerad Skriv ut utförliga utdata.
-?, -h, --hjälp (för hjälp) Visa hjälp- och användningsinformation.

Inställningskommando

Ändra inställningarna för Microsoft Store Developer CLI.

Usage

msstore settings

Options

Option Description
-t, --aktiveraTelemetri Aktivera (tom/sant) eller Inaktivera (falsk) telemetri.
-v, --detaljerad Skriv ut utförliga utdata.
-?, -h, --hjälp (för hjälp) Visa hjälp- och användningsinformation.

SetPDN-Sub-Command

Ange egenskapen Utgivarens Visningsnamn.

Usage

msstore settings setpdn <publisherDisplayName>

Arguments

Argument Description
publisherDisplayName Egenskapen för visningsnamn för förlag som ska anges globalt.

Options

Option Description
-?, -h, --hjälp (för hjälp) Visa hjälp- och användningsinformation.

Överföringskommando

Underkommando Description
status Hämtar status för en insändning.
få Hämtar metadata och paketinformation för en specifik överföring.
getListingAssets Hämtar tillgångslistorna för en specifik inlämning.
updateMetadata Uppdaterar metadata för en specifik inskick.
uppdatera Uppdaterar paketinformationen för en specifik sändning.
enkät Kontrollerar statusen för en inlämning.
publicera Publicerar en specifik inlämning.

Sändning – status – användning

msstore submission status <productId>

Arguments

Argument Description
productId Partnercenter-ID

Options

Option Description
-v, --detaljerad Skriv ut utförliga utdata.
-?, -h, --hjälp (för hjälp) Visa hjälp- och användningsinformation.

Sändning – Hämta – Användning

msstore submission get <productId>

Arguments

Argument Description
productId Partnercenter-ID

Options

Option Description
-l, --språk Välj vilket språk du vill hämta. [standard: sv]
-v, --detaljerad Skriv ut utförliga utdata.
-?, -h, --hjälp (för hjälp) Visa hjälp- och användningsinformation.

Submission – GetListingAssets – Användning

msstore submission getListingAssets <productId>

Arguments

Argument Description
productId Partnercenter-ID

Options

Option Description
-l, --språk Välj vilket språk du vill hämta. [standard: sv]
-v, --detaljerad Skriv ut utförliga utdata.
-?, -h, --hjälp (för hjälp) Visa hjälp- och användningsinformation.

Överföring – UpdateMetadata – Användning

msstore submission updateMetadata <productId> <metadata>

Arguments

Argument Description
productId Partnercenter-ID
metadata Den uppdaterade JSON-metadatarepresentationen.

Options

Option Description
-s, --hoppaÖverInitialPolling Hoppa över den första avsökningen innan du kör åtgärden. [förval: False]
-v, --detaljerad Skriv ut utförliga utdata.
-?, -h, --hjälp (för hjälp) Visa hjälp- och användningsinformation.

Sändning – Uppdatering – Användning

msstore submission update <productId> <package>

Arguments

Argument Description
productId Partnercenter-ID
package Den uppdaterade JSON-representationen av apppaketet.

Options

Option Description
-s, --hoppaÖverInitialPolling Hoppa över den första avsökningen innan du kör åtgärden. [förval: False]
-v, --detaljerad Skriv ut utförliga utdata.
-?, -h, --hjälp (för hjälp) Visa hjälp- och användningsinformation.

Tips/Råd

Använd submission get för att hämta det aktuella paketets JSON innan du anropar submission update. Detta säkerställer att du arbetar med rätt struktur och aktuella värden. Till exempel i 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

Mer kontext finns i Publicera appuppdateringar till Microsoft Store med GitHub Actions.

Insändning – omröstning – användning

msstore submission poll <productId>

Arguments

Argument Description
productId Partnercenter-ID

Options

Option Description
-v, --detaljerad Skriv ut utförliga utdata.
-?, -h, --hjälp (för hjälp) Visa hjälp- och användningsinformation.

Sändning – Publicera – Användning

msstore submission publish <productId>

Arguments

Argument Description
productId Partnercenter-ID

Options

Option Description
-v, --detaljerad Skriv ut utförliga utdata.
-?, -h, --hjälp (för hjälp) Visa hjälp- och användningsinformation.

CI/CD-miljöer

MICROSOFT STORE Developer CLI (förhandsversion) stöder körning i CI/CD-miljöer. Det innebär att du kan använda Microsoft Store Developer CLI (förhandsversion) i dina CI/CD-pipelines för att till exempel automatiskt publicera dina program till Microsoft Store.

Det första steg för att uppnå detta är att installera Microsoft Store Developer CLI (förhandsversion) i DIN CI/CD-miljö. Du hittar anvisningar om hur du gör detta här.

När du har installerat Microsoft Store Developer CLI (förhandsversion) måste du konfigurera din miljö för att kunna köra kommandon. Du kan göra detta genom att köra msstore reconfigure kommandot med de specifika parametrar som identifierar ditt partnercenterkonto (TenantId, SellerId, ClientId). Du måste också ange antingen en ClientSecret eller ett certifikat.

Det är mycket viktigt att dölja dessa autentiseringsuppgifter eftersom de visas i loggarna för din CI/CD-pipeline. Du kan göra detta med hjälp av hemligheter. Varje CI/CD-pipelinesystem har olika namn för dessa hemligheter. Azure DevOps kallar dem Secret Variables, men GitHub Actions kallar dem Krypterade Secrets. Skapa en hemlighet för var och en av parametrarna (TenantId, SellerId, ClientId och ClientSecret eller ett certifikat) och använd reconfigure sedan kommandot för att konfigurera din miljö.

Till exempel:

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

När det här kommandot har körts konfigureras Microsoft Store Developer CLI (förhandsversion) för att använda de angivna autentiseringsuppgifterna. Nu kan du använda Microsoft Store Developer CLI (förhandsversion) i CI/CD-pipelinen.

  • Last updated on