Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Installatie
Stap 1: .NET Windows Runtime installeren
Als u dit nog niet hebt gedaan, installeert u de nieuwste versie van .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 in Windows
U kunt de Microsoft Store Developer CLI downloaden uit 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 .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 het macOS.tar.gz-bestand voor uw specifieke architectuur (x64 of Arm64) downloaden van de Microsoft Store Developer CLI releases-pagina. 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 .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 via de releasepagina van Microsoft Store Developer CLI. Nadat u het archief hebt gedownload, extraheert u het en plaatst u het in uw PATH, hoe u dat 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
U 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 | 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, --certificateThumbprint | 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 | Help- en gebruiksgegevens weergeven. |
Commando Instellingen
Wijzig de instellingen van de Microsoft Store Developer CLI.
Usage
msstore settings
Options
| Optie | Description |
|---|---|
| -t, --enableTelemetry | Schakel telemetrie in (leeg/waar) of schakel telemetrie uit. |
| -v, --uitgebreid | Gedetailleerde uitvoer afdrukken. |
| -?, -h, --help | Help- en gebruiksgegevens weergeven. |
SetPDN-Sub-Command
Stel de weergavenaam-eigenschap van de Publisher in.
Usage
msstore settings setpdn <publisherDisplayName>
Arguments
| Argument | Description |
|---|---|
publisherDisplayName |
De weergavenaam-eigenschap van de uitgever die wereldwijd wordt ingesteld. |
Options
| Optie | Description |
|---|---|
| -?, -h, --help | 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 | Uitgebreide uitvoer afdrukken. |
| -?, -h, --help | 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 | Gedetailleerde uitvoer afdrukken. |
| -?, -h, --help | Help- en gebruiksgegevens weergeven. |
Inzending - GetListingAssets - Gebruik
msstore submission getListingAssets <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 | 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, --skipInitialPolling | Sla de eerste polling over voordat u de actie uitvoert. [standaard: Onwaar] |
| -v, --uitgebreid | Uitvoer afdrukken in verbose-modus. |
| -?, -h, --help | 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, --skipInitialPolling | Sla de eerste polling over voordat u de actie uitvoert. [standaard: Onwaar] |
| -v, --uitgebreid | Uitvoer afdrukken in verbose-modus. |
| -?, -h, --help | Help- en gebruiksgegevens weergeven. |
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 | 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 | 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 geheime variabelen, maar GitHub Action 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 (GitHub-acties)
- 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 }}
Na het uitvoeren van deze opdracht wordt de Microsoft Store Developer CLI (preview) geconfigureerd voor het gebruik van de opgegeven inloggegevens. U kunt nu de Microsoft Store Developer CLI (preview) in uw CI/CD-pijplijn gebruiken.
Met ons samenwerken op GitHub
De bron voor deze inhoud vindt u op GitHub, waar u ook problemen en pull-aanvragen kunt maken en controleren. Bekijk onze gids voor inzenders voor meer informatie.
Windows developer