Skip to content

New GResellerSubscription

Spencer Varney edited this page Dec 27, 2016 · 3 revisions

New-GResellerSubscription

SYNOPSIS

Creates/Transfers a subscription for the customer.

SYNTAX

New-GResellerSubscription [-TargetCustomerId] <String> [[-SubscriptionBody] <Subscription>]
 [-BillingMethod] <String> [-CreationTime] <Int64> [-CustomerDomain] <String> [-CustomerId] <String>
 [[-DealCode] <String>] [-PlanCommitmentIntervalEndTime] <Int64> [-PlanCommitmentIntervalStartTime] <Int64>
 [-IsCommitmentPlan] <Boolean> [-PlanName] <String> [[-PurchaseOrderId] <String>] [-RenewalType] <String>
 [-ResourceUiUrl] <String> [-NumberOfSeats] <Int32> [-MaximumNumberOfSeats] <Int32>
 [-LicensedNumberOfSeats] <Int32> [-SkuId] <String> [[-Status] <StatusEnum>] [-SubscriptionId] <String>
 [-MinimumTransferableSeats] <Int32> [-TransferabilityExpirationTime] <Int64> [-IsInTrial] <Boolean>
 [-TrialEndTime] <Int64> [[-CustomerAuthToken] <String>] [-StandardQueryParams <StandardQueryParameters>]
 [-GAuthId <String>] [-WhatIf] [-Confirm]

DESCRIPTION

Creates/Transfers a subscription for the customer.

EXAMPLES

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

PS C:\> New-GResellerSubscription -CustomerId $SomeCustomerIdString -SubscriptionBody $SomeSubscriptionObj

This automatically generated example serves to show the bare minimum required to call this Cmdlet.

Additional examples may be added, viewed and edited by users on the community wiki at the URL found in the related links.

PARAMETERS

-TargetCustomerId

Id of the Customer

Type: String
Parameter Sets: (All)
Aliases: 

Required: True
Position: 0
Default value: 
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-SubscriptionBody

JSON template for a subscription.

Type: Subscription
Parameter Sets: (All)
Aliases: 

Required: False
Position: 1
Default value: 
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-BillingMethod

Billing method of this subscription.

Type: String
Parameter Sets: (All)
Aliases: 

Required: True
Position: 1
Default value: 
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-CreationTime

Creation time of this subscription in milliseconds since Unix epoch.

Type: Int64
Parameter Sets: (All)
Aliases: 

Required: True
Position: 2
Default value: 0
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-CustomerDomain

Primary domain name of the customer

Type: String
Parameter Sets: (All)
Aliases: 

Required: True
Position: 3
Default value: 
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-CustomerId

The id of the customer to whom the subscription belongs.

Type: String
Parameter Sets: (All)
Aliases: 

Required: True
Position: 4
Default value: 
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-DealCode

External name of the deal, if this subscription was provisioned under one. Otherwise this field will be empty.

Type: String
Parameter Sets: (All)
Aliases: 

Required: False
Position: 5
Default value: 
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-PlanCommitmentIntervalEndTime

End time of the commitment interval in milliseconds since Unix epoch.

Type: Int64
Parameter Sets: (All)
Aliases: 

Required: True
Position: 6
Default value: 0
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-PlanCommitmentIntervalStartTime

Start time of the commitment interval in milliseconds since Unix epoch.

Type: Int64
Parameter Sets: (All)
Aliases: 

Required: True
Position: 7
Default value: 0
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-IsCommitmentPlan

Whether the plan is a commitment plan or not.

Type: Boolean
Parameter Sets: (All)
Aliases: 

Required: True
Position: 8
Default value: False
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-PlanName

The plan name of this subscription's plan.

Type: String
Parameter Sets: (All)
Aliases: 

Required: True
Position: 9
Default value: 
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-PurchaseOrderId

Purchase order id for your order tracking purposes.

Type: String
Parameter Sets: (All)
Aliases: 

Required: False
Position: 10
Default value: 
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-RenewalType

Subscription renewal type.

Type: String
Parameter Sets: (All)
Aliases: 

Required: True
Position: 11
Default value: 
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-ResourceUiUrl

Ui url for subscription resource.

Type: String
Parameter Sets: (All)
Aliases: 

Required: True
Position: 12
Default value: 
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-NumberOfSeats

Number of seats to purchase. This is applicable only for a commitment plan.

Type: Int32
Parameter Sets: (All)
Aliases: 

Required: True
Position: 13
Default value: 0
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-MaximumNumberOfSeats

Maximum number of seats that can be purchased. This needs to be provided only for a non-commitment plan. For a commitment plan it is decided by the contract.

Type: Int32
Parameter Sets: (All)
Aliases: 

Required: True
Position: 14
Default value: 0
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-LicensedNumberOfSeats

Read-only field containing the current number of licensed seats for FLEXIBLE Google-Apps subscriptions and secondary subscriptions such as Google-Vault and Drive-storage.

Type: Int32
Parameter Sets: (All)
Aliases: 

Required: True
Position: 15
Default value: 0
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-SkuId

Name of the sku for which this subscription is purchased.

Type: String
Parameter Sets: (All)
Aliases: 

Required: True
Position: 16
Default value: 
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Status

Status of the subscription.

Possible values: ACTIVE, BILLING_ACTIVATION_PENDING, CANCELLED, PENDING

Type: StatusEnum
Parameter Sets: (All)
Aliases: 
Accepted values: ACTIVE, BILLING_ACTIVATION_PENDING, CANCELLED, PENDING

Required: False
Position: 17
Default value: ACTIVE
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-SubscriptionId

The id of the subscription.

Type: String
Parameter Sets: (All)
Aliases: 

Required: True
Position: 18
Default value: 
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-MinimumTransferableSeats

Minimum number of seats listed in the transfer order for this product. For example, if the customer has 20 users, the reseller cannot place a transfer order of 15 seats. The minimum is 20 seats.

Type: Int32
Parameter Sets: (All)
Aliases: 

Required: True
Position: 19
Default value: 0
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-TransferabilityExpirationTime

Time when transfer token or intent to transfer will expire.

Type: Int64
Parameter Sets: (All)
Aliases: 

Required: True
Position: 20
Default value: 0
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-IsInTrial

Whether the subscription is in trial.

Type: Boolean
Parameter Sets: (All)
Aliases: 

Required: True
Position: 21
Default value: False
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-TrialEndTime

End time of the trial in milliseconds since Unix epoch.

Type: Int64
Parameter Sets: (All)
Aliases: 

Required: True
Position: 22
Default value: 0
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-CustomerAuthToken

An auth token needed for transferring a subscription. Can be generated at https://www.google.com/a/cpanel/customer-domain/TransferToken. Optional.

Type: String
Parameter Sets: (All)
Aliases: 

Required: False
Position: 23
Default value: 
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-StandardQueryParams

A Standard Query Parameters Object.

Type: StandardQueryParameters
Parameter Sets: (All)
Aliases: 

Required: False
Position: Named
Default value: 
Accept pipeline input: False
Accept wildcard characters: False

-GAuthId

The GAuthId representing the gShell auth credentials this cmdlet should use to run.

Type: String
Parameter Sets: (All)
Aliases: 

Required: False
Position: Named
Default value: 
Accept pipeline input: False
Accept wildcard characters: False

INPUTS

System.String

Id of the Customer

Google.Apis.Reseller.v1.Data.Subscription

JSON template for a subscription.

System.String

Billing method of this subscription.

System.Int64

Creation time of this subscription in milliseconds since Unix epoch.

System.String

Primary domain name of the customer

System.String

The id of the customer to whom the subscription belongs.

System.String

External name of the deal, if this subscription was provisioned under one. Otherwise this field will be empty.

System.Int64

End time of the commitment interval in milliseconds since Unix epoch.

System.Int64

Start time of the commitment interval in milliseconds since Unix epoch.

System.Boolean

Whether the plan is a commitment plan or not.

System.String

The plan name of this subscription's plan.

System.String

Purchase order id for your order tracking purposes.

System.String

Subscription renewal type.

System.String

Ui url for subscription resource.

System.Int32

Number of seats to purchase. This is applicable only for a commitment plan.

System.Int32

Maximum number of seats that can be purchased. This needs to be provided only for a non-commitment plan. For a commitment plan it is decided by the contract.

System.Int32

Read-only field containing the current number of licensed seats for FLEXIBLE Google-Apps subscriptions and secondary subscriptions such as Google-Vault and Drive-storage.

System.String

Name of the sku for which this subscription is purchased.

gShell.Cmdlets.Reseller.Subscription.NewGResellerSubscriptionCommand+StatusEnum

Status of the subscription.

System.String

The id of the subscription.

System.Int32

Minimum number of seats listed in the transfer order for this product. For example, if the customer has 20 users, the reseller cannot place a transfer order of 15 seats. The minimum is 20 seats.

System.Int64

Time when transfer token or intent to transfer will expire.

System.Boolean

Whether the subscription is in trial.

System.Int64

End time of the trial in milliseconds since Unix epoch.

System.String

An auth token needed for transferring a subscription. Can be generated at https://www.google.com/a/cpanel/customer-domain/TransferToken. Optional.

OUTPUTS

NOTES

Part of the gShell Project, relating to the Google Reseller API; see Related Links or use the -Online parameter.

RELATED LINKS

[Wiki page for this Cmdlet]

[Getting started with gShell]

Clone this wiki locally