Share via


New-AzsOffer

Creates a new offer.

Syntax

New-AzsOffer
   [-Name] <String>
   [-DisplayName] <String>
   [-ResourceGroupName] <String>
   [[-BasePlanIds] <String[]>]
   [[-Description] <String>]
   [[-ExternalReferenceId] <String>]
   [[-State] <String>]
   [[-Location] <String>]
   [[-MaxSubscriptionsPerAccount] <Int64>]
   [[-SubscriptionCount] <Int64>]
   [[-AddonPlanDefinition] <AddonPlanDefinition[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Create or update the offer.

Examples

-------------------------- EXAMPLE 1 --------------------------

New-AzsOffer -Name offer1 -ResourceGroupName rg1 -State Public -DisplayName "offer1" -BasePlanIds "/subscriptions/0a823c45-d9e7-4812-a138-74e22213693a/resourceGroups/rg1/providers/Microsoft.Subscriptions.Admin/plans/plan1"

Creates a new offer.

Parameters

-AddonPlanDefinition

References to add-on plans that a tenant can optionally acquire as a part of the offer.

Type:AddonPlanDefinition[]
Position:11
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BasePlanIds

Identifiers of the base plans that become available to the tenant immediately when a tenant subscribes to the offer.

Type:String[]
Position:4
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Description of offer.

Type:String
Position:5
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Display name of offer.

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ExternalReferenceId

External reference identifier.

Type:String
Position:6
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Location

Location of the resource.

Type:String
Aliases:ArmLocation
Position:8
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxSubscriptionsPerAccount

Maximum subscriptions per account.

Type:Int64
Position:9
Default value:0
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Name of an offer.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

The resource group the resource is located under.

Type:String
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-State

Offer accessibility state. Default value is Private. This parameter will be deprecated in a future release

Type:String
Position:7
Default value:Private
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SubscriptionCount

Current subscription count.

Type:Int64
Position:10
Default value:0
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Outputs

Microsoft.AzureStack.Management.Subscriptions.Admin.Models.Offer