Dela via


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 i 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 Microsoft Store Developer CLI-utgåvor. 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-versionerna. När du har laddat ned det, extraherar du arkivet och placerar det i din "PATH", på det sätt du vill, 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, --help Visa hjälp- och användningsinformation.

Konfigurera om kommandot

Konfigurera om verktyget 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, --tenantId 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, --certificatePassword Ange certifikatlösenordet som ska användas.
--återställ Återställ bara autentiseringsuppgifterna utan att starta om.
-v, --verbose Skriv ut utförliga utdata.
-?, -h, --help Visa hjälp- och användningsinformation.

Inställningskommando

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

Usage

msstore settings

Options

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

SetPDN-Sub-Command

Ange egenskapen Visningsnamn för utgivare.

Usage

msstore settings setpdn <publisherDisplayName>

Arguments

Argument Description
publisherDisplayName Egenskapen Visningsnamn för utgivare som kommer att fastställas globalt.

Options

Option Description
-?, -h, --help Visa hjälp- och användningsinformation.

Överföringskommando

Underkommando Description
status Hämtar status för en insändning.
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, --verbose Skriv ut utförliga utdata.
-?, -h, --help 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, --verbose Skriv ut utförliga utdata.
-?, -h, --help 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, --verbose Skriv ut utförliga utdata.
-?, -h, --help 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, --verbose Skriv ut utförliga utdata.
-?, -h, --help 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ÖverInledandeKontroll Hoppa över den första omröstningen innan du kör åtgärden. [förvald: False]
-v, --verbose Skriv ut utförliga utdata.
-?, -h, --help Visa hjälp- och användningsinformation.

Insändning – omröstning – användning

msstore submission poll <productId>

Arguments

Argument Description
productId Partnercenter-ID

Options

Option Description
-v, --verbose Skriv ut utförliga utdata.
-?, -h, --help 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, --verbose Skriv ut utförliga utdata.
-?, -h, --help 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 till exempel hemliga variabler, men GitHub Action kallar dem krypterade hemligheter. 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 din CI/CD-pipeline.