Opdrachten (MSI/EXE)

Installatie

Stap 1: .NET Windows Runtime installeren

Als u dit nog niet hebt gedaan, installeert u de nieuwste versie van de .NET 8 Desktop Runtime. Dit is een vereiste om de Microsoft Store Developer CLI uit te voeren.

De eenvoudigste manier om deze te installeren is door winget te gebruiken:

winget install Microsoft.DotNet.DesktopRuntime.8

Stap 2: De Microsoft Store Developer CLI installeren op Windows

U kunt de Microsoft Store Developer CLI downloaden via de Microsoft Store. U kunt ook winget gebruiken:

winget install "Microsoft Store Developer CLI"

Stap 1: .NET macOS Runtime installeren

Als u dit nog niet hebt gedaan, installeert u de nieuwste versie van de .NET 8 Runtime. Dit is een vereiste om de Microsoft Store Developer CLI uit te voeren.

Stap 2: de Microsoft Store Developer CLI installeren in macOS

U kunt de macOS-.tar.gz voor uw specifieke architectuur (x64 of Arm64) downloaden op de pagina Microsoft Store Developer CLI-releases. Nadat u het archief hebt gedownload, extraheert u het en plaatst u het in uw PATH, op welke manier u dat ook wilt doen, bijvoorbeeld:

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

Je kunt ook brew gebruiken:

brew install microsoft/msstore-cli/msstore-cli

Stap 1: .NET Linux Runtime installeren

Als u dit nog niet hebt gedaan, installeert u de nieuwste versie van de .NET 8 Runtime. Dit is een vereiste om de Microsoft Store Developer CLI uit te voeren.

Stap 2: de Microsoft Store Developer CLI installeren in Linux

U kunt de Linux-.tar.gz voor uw specifieke architectuur (x64 of Arm64) downloaden vanaf de Microsoft Store developer CLI-releasespagina. Nadat u het archief hebt gedownload, extraheert u het en plaatst u het in uw PATH, op welke manier u dat ook wilt doen, bijvoorbeeld:

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

Je kunt ook brew gebruiken:

brew install microsoft/msstore-cli/msstore-cli

Infocommando

Bestaande configuratie afdrukken.

Usage

msstore info

Options

Optie Description
-v, --uitgebreid Uitvoer afdrukken in verbose-modus.
-?, -h, --help (Hulp) Help- en gebruiksgegevens weergeven.

Opdracht opnieuw configureren

Configureer de Microsoft Store Developer CLI opnieuw. U kunt een clientgeheim of een certificaat opgeven. Certificaten kunnen worden opgegeven via de vingerafdruk of door een bestandspad op te geven (met of zonder een wachtwoord).

Usage

msstore reconfigure

Options

Optie Description
-t, --tenant-ID Geef de tenant-id op die moet worden gebruikt.
-s, --sellerId Geef de verkoper-id op die moet worden gebruikt.
-c, --clientId Geef de client-id op die moet worden gebruikt.
-cs, --clientSecret Geef het clientgeheim op dat moet worden gebruikt.
-ct, --certificaatVingerafdruk Geef de vingerafdruk van het certificaat op die moet worden gebruikt.
-cfp, --certificateFilePath Geef het pad naar het certificaatbestand op dat moet worden gebruikt.
-cp, --certificatePassword Geef het certificaatwachtwoord op dat moet worden gebruikt.
--resetten Stel alleen de inloggegevens opnieuw in, zonder opnieuw te beginnen.
-v, --uitgebreid Uitvoer afdrukken in verbose-modus.
-?, -h, --help (Hulp) Help- en gebruiksgegevens weergeven.

Commando Instellingen

Wijzig de instellingen van de Microsoft Store Developer CLI.

Usage

msstore settings

Options

Optie Description
-t, --telemetrieInschakelen Schakel telemetrie in (leeg/waar) of schakel telemetrie uit.
-v, --uitgebreid Uitvoer afdrukken in verbose-modus.
-?, -h, --help (Hulp) Help- en gebruiksgegevens weergeven.

SetPDN-Sub-Command

Stel de eigenschap 'Weergavenaam uitgever' in.

Usage

msstore settings setpdn <publisherDisplayName>

Arguments

Argument Description
publisherDisplayName De eigenschap Publisher Weergavenaam die wereldwijd wordt ingesteld.

Options

Optie Description
-?, -h, --help (Hulp) Help- en gebruiksgegevens weergeven.

Opdracht Indienen

Sub-Opdracht Description
status Hiermee haalt u de status van een inzending op.
verkrijg Hiermee haalt u de metagegevens en pakketgegevens van een specifieke inzending op.
getListingAssets Hiermee haalt u de vermeldingsassets van een specifieke inzending op.
updateMetadata Hiermee worden de metagegevens van een specifieke inzending bijgewerkt.
update Hiermee wordt de pakketgegevens van een specifieke inzending bijgewerkt.
polling Peilt de status van een inzending.
publiceren Hiermee publiceert u een specifieke inzending.

Inzending - Status - Gebruik

msstore submission status <productId>

Arguments

Argument Description
productId De partnercentrum-id.

Options

Optie Description
-v, --uitgebreid Uitvoer afdrukken in verbose-modus.
-?, -h, --help (Hulp) Help- en gebruiksgegevens weergeven.

Inzending - Ophalen - Gebruik

msstore submission get <productId>

Arguments

Argument Description
productId De partnercentrum-id.

Options

Optie Description
-l, --language Selecteer de taal die u wilt ophalen. [standaard: en]
-v, --uitgebreid Uitvoer afdrukken in verbose-modus.
-?, -h, --help (Hulp) Help- en gebruiksgegevens weergeven.

Inzending - GetListingAssets - Gebruik

msstore submission getListingAssets <productId>

Arguments

Argument Description
productId De partnercentrum-id.

Options

Optie Description
-l, --taal Selecteer de taal die u wilt ophalen. [standaard: en]
-v, --uitgebreid Uitvoer afdrukken in verbose-modus.
-?, -h, --help (Hulp) Help- en gebruiksgegevens weergeven.

Inzending - BijwerkenMetadata - Gebruik

msstore submission updateMetadata <productId> <metadata>

Arguments

Argument Description
productId De partnercentrum-id.
metadata De bijgewerkte weergave van JSON-metagegevens.

Options

Optie Description
-s, --overslaanInitieelPolleren Sla de eerste polling over voordat u de actie uitvoert. [standaard: Onwaar]
-v, --uitgebreid Uitvoer afdrukken in verbose-modus.
-?, -h, --help (Hulp) Help- en gebruiksgegevens weergeven.

Inzending - Bijwerken - Gebruik

msstore submission update <productId> <package>

Arguments

Argument Description
productId De partnercentrum-id.
package De bijgewerkte JSON-weergave van het app-pakket.

Options

Optie Description
-s, --overslaanInitieelPolleren Sla de eerste polling over voordat u de actie uitvoert. [standaard: Onwaar]
-v, --uitgebreid Uitvoer afdrukken in verbose-modus.
-?, -h, --help (Hulp) Help- en gebruiksgegevens weergeven.

Aanbeveling

Gebruik submission get dit om de huidige pakket-JSON op te halen voordat u aanroept submission update. Dit zorgt ervoor dat u met de juiste structuur en huidige waarden werkt. Bijvoorbeeld 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

Zie App-updates publiceren voor Microsoft Store met GitHub Actions voor meer context.

Inzending - Peiling - Gebruik

msstore submission poll <productId>

Arguments

Argument Description
productId De partnercentrum-id.

Options

Optie Description
-v, --uitgebreid Uitvoer afdrukken in verbose-modus.
-?, -h, --help (Hulp) Help- en gebruiksgegevens weergeven.

Inzending - Publiceren - Gebruik

msstore submission publish <productId>

Arguments

Argument Description
productId De partnercentrum-id.

Options

Optie Description
-v, --uitgebreid Uitvoer afdrukken in verbose-modus.
-?, -h, --help (Hulp) Help- en gebruiksgegevens weergeven.

CI/CD-omgevingen

De Microsoft Store Developer CLI (preview) ondersteunt uitvoering in CI/CD-omgevingen. Dit betekent dat u de Microsoft Store Developer CLI (preview) in uw CI/CD-pijplijnen kunt gebruiken om uw toepassingen bijvoorbeeld automatisch naar de Microsoft Store te publiceren.

De eerste stap om dit te bereiken om de Microsoft Store Developer CLI (preview) te installeren in uw CI/CD-omgeving. Hier vindt u instructies voor hoe u dit doet.

Nadat u de Microsoft Store Developer CLI (preview) hebt geïnstalleerd, moet u uw omgeving configureren om opdrachten uit te voeren. U kunt dit doen door de msstore reconfigure opdracht uit te voeren met de specifieke parameters waarmee uw partnercentrumaccount wordt geïdentificeerd (TenantId, SellerId, ClientId). U moet ook een ClientSecret of een certificaat opgeven.

Het is erg belangrijk om deze referenties te verbergen, omdat ze zichtbaar zijn in de logboeken van uw CI/CD-pijplijn. U kunt dit doen met behulp van geheimen. Elk CI/CD-pijplijnsysteem heeft verschillende namen voor deze geheimen. Azure DevOps noemt ze bijvoorbeeld Secret Variables, maar GitHub Actions noemt ze Versleutelde Geheimen. Maak één geheim voor elk van de parameters (TenantId, SellerId, ClientId en ClientSecret of een certificaat) en gebruik vervolgens de reconfigure opdracht om uw omgeving in te stellen.

Voorbeeld:

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

Zodra deze opdracht is uitgevoerd, wordt de Microsoft Store Developer CLI (preview) geconfigureerd voor het gebruik van de verstrekte referenties. U kunt nu de Microsoft Store Developer CLI (preview) in uw CI/CD-pijplijn gebruiken.

  • Last updated on