Get-BT_Subscription

Syntax

Get-BT_Subscription -Ticket <Ticket> [-Environment <string>] [-PageOffset <int>] [-PageSize <int>] [-RetrieveAll] [-ShouldUnmaskProperties <bool>] [-Id <Object[]>] [-IsDeleted <string>] [-Created <string[]>] [-SortBy_Created_Ascending] [-SortBy_Created_Descending] [-Updated <string[]>] [-SortBy_Updated_Ascending] [-SortBy_Updated_Descending] [-Version <Object[]>] [-SortBy_Version_Ascending] [-SortBy_Version_Descending] [-SystemUserId <Object[]>] [-WorkgroupOrganizationId <Object[]>] [-SubscriptionStartDate <string[]>] [-SortBy_SubscriptionStartDate_Ascending] [-SortBy_SubscriptionStartDate_Descending] [-SubscriptionEndDate <string[]>] [-SortBy_SubscriptionEndDate_Ascending] [-SortBy_SubscriptionEndDate_Descending] [-BillingStartDate <string[]>] [-SortBy_BillingStartDate_Ascending] [-SortBy_BillingStartDate_Descending] [-BillingEndDate <string[]>] [-SortBy_BillingEndDate_Ascending] [-SortBy_BillingEndDate_Descending] [-ProductSkuId <Object[]>] [-AgreementMonths <Object[]>] [-SortBy_AgreementMonths_Ascending] [-SortBy_AgreementMonths_Descending] [-SubscriptionProrationType <string[]>] [-BillingFrequencyMonths <Object[]>] [-SortBy_BillingFrequencyMonths_Ascending] [-SortBy_BillingFrequencyMonths_Descending] [-SubscriptionProcessState <string[]>] [-ErrorCode <string[]>] [-SubscriptionRenewalPolicy <string[]>] [-ReferenceEntityId <Object[]>] [-EntityReferenceId <Object[]>] [-ReferenceEntityType <string[]>] [-SubscriptionEntityReferenceType <string[]>] [<CommonParameters>]

Get-BT_Subscription -Ticket <Ticket> -EndpointUrl <string> [-PageOffset <int>] [-PageSize <int>] [-RetrieveAll] [-ShouldUnmaskProperties <bool>] [-Id <Object[]>] [-IsDeleted <string>] [-Created <string[]>] [-SortBy_Created_Ascending] [-SortBy_Created_Descending] [-Updated <string[]>] [-SortBy_Updated_Ascending] [-SortBy_Updated_Descending] [-Version <Object[]>] [-SortBy_Version_Ascending] [-SortBy_Version_Descending] [-SystemUserId <Object[]>] [-WorkgroupOrganizationId <Object[]>] [-SubscriptionStartDate <string[]>] [-SortBy_SubscriptionStartDate_Ascending] [-SortBy_SubscriptionStartDate_Descending] [-SubscriptionEndDate <string[]>] [-SortBy_SubscriptionEndDate_Ascending] [-SortBy_SubscriptionEndDate_Descending] [-BillingStartDate <string[]>] [-SortBy_BillingStartDate_Ascending] [-SortBy_BillingStartDate_Descending] [-BillingEndDate <string[]>] [-SortBy_BillingEndDate_Ascending] [-SortBy_BillingEndDate_Descending] [-ProductSkuId <Object[]>] [-AgreementMonths <Object[]>] [-SortBy_AgreementMonths_Ascending] [-SortBy_AgreementMonths_Descending] [-SubscriptionProrationType <string[]>] [-BillingFrequencyMonths <Object[]>] [-SortBy_BillingFrequencyMonths_Ascending] [-SortBy_BillingFrequencyMonths_Descending] [-SubscriptionProcessState <string[]>] [-ErrorCode <string[]>] [-SubscriptionRenewalPolicy <string[]>] [-ReferenceEntityId <Object[]>] [-EntityReferenceId <Object[]>] [-ReferenceEntityType <string[]>] [-SubscriptionEntityReferenceType <string[]>] [<CommonParameters>]

Detailed Description

Get-BT_Subscription gets a(an) BT_Subscription. Subscription entity class for storing a single subscription. Used for reoccurring billing. A subscription represents a user subscription that is required to run MSPComplete services for this user.

Parameters

Total Parameters: 58

EndpointUrl

Paremeter specs:

Required True
ValueFromPipeline False
ValueFromPipelineByPropertyName False

Ticket

Paremeter specs:

Required True
ValueFromPipeline False
ValueFromPipelineByPropertyName False

AgreementMonths

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

BillingEndDate

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

BillingFrequencyMonths

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

BillingStartDate

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

Created

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

Environment

Available values are listed below.

Value Description
BT Represents BT
Beta Represents Beta
Develop Represents Develop
Release Represents Release
Test Represents Test
China Represents China
Germany Represents Germany
Alpha Represents Alpha
Today Represents Today
Sandbox-02 Represents Sandbox-02
Sandbox-03 Represents Sandbox-03

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

ErrorCode

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

Id

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

IsDeleted

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

PageOffset

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

PageSize

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

ProductSkuId

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

ReferenceEntityId

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

ReferenceEntityType

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

RetrieveAll

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

ShouldUnmaskProperties

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

SortBy_AgreementMonths_Ascending

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

SortBy_AgreementMonths_Descending

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

SortBy_BillingEndDate_Ascending

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

SortBy_BillingEndDate_Descending

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

SortBy_BillingFrequencyMonths_Ascending

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

SortBy_BillingFrequencyMonths_Descending

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

SortBy_BillingStartDate_Ascending

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

SortBy_BillingStartDate_Descending

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

SortBy_Created_Ascending

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

SortBy_Created_Descending

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

SortBy_SubscriptionEndDate_Ascending

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

SortBy_SubscriptionEndDate_Descending

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

SortBy_SubscriptionStartDate_Ascending

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

SortBy_SubscriptionStartDate_Descending

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

SortBy_Updated_Ascending

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

SortBy_Updated_Descending

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

SortBy_Version_Ascending

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

SortBy_Version_Descending

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

SubscriptionEndDate

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

SubscriptionProcessState

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

SubscriptionProrationType

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

SubscriptionRenewalPolicy

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

SubscriptionStartDate

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

SystemUserId

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

Updated

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

Version

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

WorkgroupOrganizationId

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

Outputs

System.Object

Notes

Workgroup scope

Subscriptions belong to workgroups, thus a ticket scoped to a workgroup will only return the subscriptions belonging to this workgroup.


Subscription process state

The subscription process state can be non-processed, successfully processed, failed to processed or revoked. It is automatically updated and can take a few dozens of seconds to be updated.


Examples

-------------------------- Example 1 -------------------------

$subscriptions = Get-BT_Subscription -Ticket $btTicket