Copy page

PowerShell Module

Marketplace module

Module: businessdev.ALbuild.Marketplace  •  Tier: Licensed  •  Cmdlets: 7

The Marketplace module ingests apps to Microsoft Marketplace (AppSource) via Partner Center — authentication, product/submission lookup, creating submissions, submitting, waiting for validation and promotion. This is a licensed feature.

Cmdlets in this module

---

Get-BcMarketplaceProduct

Retrieves Business Central products from the Microsoft product-ingestion API.

Mirrors the proven Publish-AppSourceApp / Get-AppSourceProduct implementation: the product name lives in the product's 'alias' (NOT 'name'), the product type is 'dynamics365BusinessCentral' (camelCase - the hyphenated form returns 400), and the working schema version is '2022-03-01-preview3'. Results are paged via '@nextLink'.

Syntax

Code
Get-BcMarketplaceProduct
    -AuthContext <PSObject>
    [-Name <String>]
    [-ProductType <String>]
    [-ApiVersion <String>]

Parameters

Output

The product object(s) (each with id, alias, identity.externalId, ...).

---

Get-BcMarketplaceSubmission

Retrieves a product's submission(s) from the Partner Center ingestion API.

Syntax

Code
Get-BcMarketplaceSubmission
    -AuthContext <PSObject>
    -ProductId <String>
    [-SubmissionId <String>]

Parameters

Output

The submission object (latest, or the requested one).

---

Invoke-BcMarketplacePromotion

Promotes a validated Marketplace submission to live.

Syntax

Code
Invoke-BcMarketplacePromotion
    -AuthContext <PSObject>
    -ProductId <String>
    -SubmissionId <String>

Parameters

Output

The updated submission status object.

---

New-BcMarketplaceAuthContext

Acquires an OAuth2 access token for the Microsoft Marketplace / Partner Center APIs.

Client-credentials OAuth2 against Azure AD, returning an auth context for the other Marketplace cmdlets. The Partner Center ingestion API and the Graph product-ingestion API use different scopes - pass the appropriate -Scope. The context carries the numeric PublisherId (Seller ID), which the Partner Center ingestion API requires as the 'x-ms-publisherId' header, and the client id/secret so the token can be renewed (Update-BcMarketplaceAuthContext) during long submissions. Mirrors the proven Publish-AppSourceApp / New-AppSourceAuthContext implementation.

Syntax

Code
New-BcMarketplaceAuthContext
    -TenantId <String>
    -ClientId <String>
    -ClientSecret <Object>
    [-Scope <String>]
    [-PublisherId <String>]

Parameters

Output

PSCustomObject: AccessToken, TokenType, ExpiresOn, ClientId, ClientSecret, TenantId, Scope, Authority, PublisherId.

---

New-BcMarketplaceSubmission

Uploads app package(s) and creates a Marketplace (AppSource) submission via Partner Center.

Faithful port of the proven Publish-AppSourceApp / New-AppSourceSubmission flow (Partner Center ingestion API v1.0), so ALbuild submits exactly the way that works:

1. read the product's Package branch + package configuration;
2. upload the main app (Dynamics365BusinessCentralAddOnExtensionPackage) and the library apps (Dynamics365BusinessCentralAddOnLibraryExtensionPackage - zipped into one archive when there is more than one) to Azure Blob Storage via the package SAS URI, marking each Processed (with a 409-conflict cleanup+retry), and adding a package reference;
3. bump the product's appVersion property from the app manifest (rejecting a downgrade);
4. update the package configuration and create a 'preview' submission;
5. optionally wait for validation and auto-promote to live. Requires the Az.Storage module (blob upload) and the auth context's PublisherId (x-ms-publisherId).

Syntax

Code
New-BcMarketplaceSubmission
    -AuthContext <PSObject>
    -ProductId <String>
    -AppFile <String>
    [-LibraryAppFile <String[]>]
    [-AutoPromote]
    [-DoNotWait]
    [-TimeoutMinutes <Int32>]

Parameters

Output

PSCustomObject: ProductId, SubmissionId, AppFile, Libraries, State, Substate, Promoted.

---

Submit-BcMarketplaceApp

Submits an AL app to Microsoft Marketplace (AppSource) end to end.

Orchestrates a Marketplace submission: authenticates (Partner Center and product-ingestion scopes), resolves the product by name, uploads the app (and library apps) and creates a submission, waits for validation, and optionally promotes it to live. Requires a valid ALbuild license.

Syntax

Code
Submit-BcMarketplaceApp
    [-ProductName <String>]
    -AppPath <String>
    [-LibraryAppPath <String[]>]
    -AppFile <String>
    [-LibraryAppFile <String[]>]
    -TenantId <String>
    -ClientId <String>
    -ClientSecret <Object>
    -PublisherId <String>
    [-AutoPromote]
    [-TimeoutMinutes <Int32>]

Parameters

Output

PSCustomObject with ProductId, SubmissionId, State, Substate, Promoted.

---

Wait-BcMarketplaceValidation

Waits for a Marketplace submission to finish validation.

Polls the submission until it reaches a publishable state (Published/ReadyToPublish), fails, or the timeout elapses. The auth token is refreshed when -AuthContextFactory is supplied (useful for long validations).

Syntax

Code
Wait-BcMarketplaceValidation
    -AuthContext <PSObject>
    -ProductId <String>
    -SubmissionId <String>
    [-TimeoutMinutes <Int32>]
    [-IntervalSeconds <Int32>]

Parameters

Output

PSCustomObject with State, Substate, Completed, TimedOut.

---