Project

PSPublishModule

Build, test, version, sign, and publish PowerShell modules with reusable PowerForge pipelines.

Stars 48
Forks 16
PowerShell Gallery downloads 17,213
Release v3.0.186
Language: C# Updated: 2026-11-04
Command

New-AppStoreConnectSubscriptionIntroductoryOffer

Module
PSPublishModule
Inputs
None
Outputs
PowerForge.AppStoreConnectSubscriptionIntroductoryOfferInfo

Creates an App Store Connect introductory offer for an auto-renewable subscription.

Syntax

New-AppStoreConnectSubscriptionIntroductoryOffer
-Duration <AppStoreConnectSubscriptionOfferDuration>
[-EndDate <DateTime>]
-IssuerId <String>
-KeyId <String>
[-NumberOfPeriods <Int32>]
-OfferMode <FreeTrial|PayAsYouGo|PayUpFront>
[-PrivateKey <String>]
[-PrivateKeyPath <String>]
[-StartDate <DateTime>]
-SubscriptionId <String>
[-SubscriptionPricePointId <String>]
-TerritoryId <String[]>
[-TokenLifetimeMinutes <Int32>]
[<CommonParameters>]
#
Parameter set: All Parameter Sets

Examples

Example 1

New-AppStoreConnectSubscriptionIntroductoryOffer -IssuerId 'Value' -KeyId 'Value' -SubscriptionId 'Value' -Duration 'Value' -OfferMode 'Value'

Parameters

-Duration AppStoreConnectSubscriptionOfferDuration required
Introductory-offer duration.
Possible values: ThreeDays, OneWeek, TwoWeeks, OneMonth, TwoMonths, ThreeMonths, SixMonths, OneYear
-EndDate DateTime optional
Optional offer end date.
-IssuerId String required
Issuer ID from App Store Connect API keys.
-KeyId String required
Key ID associated with the private key.
-NumberOfPeriods Int32 optional
Number of offer periods.
-OfferMode AppStoreConnectSubscriptionOfferMode required
Introductory-offer payment mode.
Possible values: FreeTrial, PayAsYouGo, PayUpFront
-PrivateKey String optional
Private key text in PEM format.
-PrivateKeyPath String optional
Path to a private key file in PEM format.
-StartDate DateTime optional
Optional offer start date.
-SubscriptionId String required
App Store Connect subscription resource id.
-SubscriptionPricePointId String optional
Subscription price point resource id for a paid offer. Paid offers accept one territory per invocation because App Store Connect price points are territory-specific.
-TerritoryId String[] required
Territory resource ids for the offer. Free trials may target multiple territories; paid offers accept one.
-TokenLifetimeMinutes Int32 optional
Token lifetime in minutes, up to 20.

Common Parameters

This command supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable.

For more information, see about_CommonParameters.