Set-AzsOffer
Create or update the offer.
Syntax
Set-AzsOffer
-Name <String>
-ResourceGroupName <String>
[-SubscriptionId <String>]
[-AddonPlanDefinition <IAddonPlanDefinition[]>]
[-BasePlanIds <String[]>]
[-Description <String>]
[-DisplayName <String>]
[-ExternalReferenceId <String>]
[-Location <String>]
[-MaxSubscriptionsPerAccount <Int32>]
[-PropertiesName <String>]
[-State <AccessibilityState>]
[-SubscriptionCount <Int32>]
[-DefaultProfile <PSObject>]
[-Confirm]
[-WhatIf]
[<CommonParameters>]
Set-AzsOffer
-OfferDefinition <IOffer>
[-SubscriptionId <String>]
[-DefaultProfile <PSObject>]
[-Confirm]
[-WhatIf]
[<CommonParameters>]
Description
Create or update the offer.
Examples
Example 1
PS C:\> $Offer = Get-AzsAdminManagedOffer | Select-Object -First 1
$Offer.MaxSubscriptionsPerAccount = 18
$Offer | Set-AzsOffer
AddonPlans : {}
BasePlanIds : {/subscriptions/d77ed1d7-cb62-4658-a777-386a8ae523dd/resourceGroups/DRPTestResourceGroup5056/providers/Microsoft.Subscriptions.Admin/plans/DRPTestPlan5056}
Description :
DisplayName : DRPTestOffer5056
ExternalReferenceId :
Id : /subscriptions/d77ed1d7-cb62-4658-a777-386a8ae523dd/resourceGroups/DRPTestResourceGroup5056/providers/Microsoft.Subscriptions.Admin/offers/DRPTestOffer5056
Location : redmond
MaxSubscriptionsPerAccount : 18
Name : DRPTestOffer5056
PropertiesName : DRPTestOffer5056
State : Private
SubscriptionCount : 5
Tags : Microsoft.Azure.PowerShell.Cmdlets.SubscriptionsAdmin.Models.Api20151101.ResourceTags
Type : Microsoft.Subscriptions.Admin/offers
Update an offer.
Parameters
-AddonPlanDefinition
References to add-on plans that a tenant can optionally acquire as a part of the offer. To construct, see NOTES section for ADDONPLANDEFINITION properties and create a hash table.
Type: | Microsoft.Azure.PowerShell.Cmdlets.SubscriptionsAdmin.Models.Api20151101.IAddonPlanDefinition[] |
Position: | Named |
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: | System.String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Prompts you for confirmation before running the cmdlet.
Type: | System.Management.Automation.SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
The credentials, account, tenant, and subscription used for communication with Azure.
Type: | System.Management.Automation.PSObject |
Aliases: | AzureRMContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Description of offer.
Type: | System.String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisplayName
Display name of offer.
Type: | System.String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExternalReferenceId
External reference identifier.
Type: | System.String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Location
Location of the resource
Type: | System.String |
Position: | Named |
Default value: | (Get-AzLocation)[0].Location |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxSubscriptionsPerAccount
Maximum subscriptions per account.
Type: | System.Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Name of an offer.
Type: | System.String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OfferDefinition
Represents an offering of services against which a subscription can be created. To construct, see NOTES section for OFFERDEFINITION properties and create a hash table.
Type: | Microsoft.Azure.PowerShell.Cmdlets.SubscriptionsAdmin.Models.Api20151101.IOffer |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PropertiesName
Name of the Offer.
Type: | System.String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
The resource group the resource is located under.
Type: | System.String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-State
Offer accessibility state.
Type: | Microsoft.Azure.PowerShell.Cmdlets.SubscriptionsAdmin.Support.AccessibilityState |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SubscriptionCount
Current subscription count.
Type: | System.Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SubscriptionId
Subscription credentials which uniquely identify Microsoft Azure subscription.The subscription ID forms part of the URI for every service call.
Type: | System.String |
Position: | Named |
Default value: | (Get-AzContext).Subscription.Id |
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: | System.Management.Automation.SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Inputs
Microsoft.Azure.PowerShell.Cmdlets.SubscriptionsAdmin.Models.Api20151101.IOffer
Outputs
Microsoft.Azure.PowerShell.Cmdlets.SubscriptionsAdmin.Models.Api20151101.IOffer
ALIASES
Notes
COMPLEX PARAMETER PROPERTIES To create the parameters described below, construct a hash table containing the appropriate properties. For information on hash tables, run Get-Help about_Hash_Tables.
ADDONPLANDEFINITION <IAddonPlanDefinition[]>: References to add-on plans that a tenant can optionally acquire as a part of the offer.
[MaxAcquisitionCount <Int32?>]
: Maximum number of instances that can be acquired by a single subscription. If not specified, the assumed value is 1.[PlanId <String>]
: Plan identifier.
OFFERDEFINITION <IOffer>
: Represents an offering of services against which a subscription can be created.
[Location <String>]
: Location of the resource[AddonPlans <IAddonPlanDefinition[]>]
: References to add-on plans that a tenant can optionally acquire as a part of the offer.[MaxAcquisitionCount <Int32?>]
: Maximum number of instances that can be acquired by a single subscription. If not specified, the assumed value is 1.[PlanId <String>]
: Plan identifier.
[BasePlanIds <String[]>]
: Identifiers of the base plans that become available to the tenant immediately when a tenant subscribes to the offer.[Description <String>]
: Description of offer.[DisplayName <String>]
: Display name of offer.[ExternalReferenceId <String>]
: External reference identifier.[MaxSubscriptionsPerAccount <Int32?>]
: Maximum subscriptions per account.[PropertiesName <String>]
: Name of the Offer.[State <AccessibilityState?>]
: Offer accessibility state.[SubscriptionCount <Int32?>]
: Current subscription count.