Skip to main content

Get-HaloRecurringInvoice

Generated Cmdlet Help

This page has been generated from the HaloAPI PowerShell module source. To make changes please edit the appropriate PowerShell source file.

SYNOPSIS

Gets recurring invoices from the Halo API.

SYNTAX

Multi (Default)

Get-HaloRecurringInvoice [-AdvancedSearch <String>] [-AssetId <Int32>] [-AwaitingApproval]
[-BillingDate <DateTime>] [-BillingCategoryIds <Int32[]>] [-ClientId <Int32>] [-ClientIds <Int32[]>]
[-ContractId <Int32>] [-Count <Int32>] [-IdOnly] [-IncludeCredits] [-IncludeInvoices] [-IncludeLines]
[-IncludePOInvoices] [-IncludeInvoiceDateEnd] [-IncludeInvoiceDateStart] [-MyApprovals] [-NotPostedOnly]
[-Order <String>] [-OrderDesc] [-Order2 <String>] [-OrderDesc2] [-Order3 <String>] [-OrderDesc3]
[-Order4 <String>] [-OrderDesc4] [-Order5 <String>] [-OrderDesc5] [-PageNo <Int32>] [-PageSize <Int32>]
[-Paginate] [-PaymentStatuses <Int32[]>] [-PostedOnly] [-PurchaseOrderId <Int32>] [-QuoteStatuses <String[]>]
[-ReadyForInvoicing] [-ReviewRequired] [-RecurringInvoiceType <String>] [-SalesOrderId <Int32>]
[-Search <String>] [-SentStatus <Int32>] [-SiteId <Int32>] [-StripeAutoPaymentRequired] [-TicketId <Int32>]
[-TopLevelId <Int32>] [-UserId <Int32>] [-FullObjects] [-ProgressAction <ActionPreference>]
[<CommonParameters>]

Single

Get-HaloRecurringInvoice -RecurringInvoiceID <Int64> [-ProgressAction <ActionPreference>] [<CommonParameters>]

DESCRIPTION

Retrieves recurring invoices from the Halo API - supports a variety of filtering parameters.

EXAMPLES

PARAMETERS

-RecurringInvoiceID

Invoice ID

Type: Int64
Parameter Sets: Single
Aliases:

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

-AdvancedSearch

The advanced search query to use.

Type: String
Parameter Sets: Multi
Aliases: advanced_search

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

-AssetId

Filter by an asset id.

Type: Int32
Parameter Sets: Multi
Aliases: asset_id

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

-AwaitingApproval

Filter for recurring invoices awaiting approval.

Type: SwitchParameter
Parameter Sets: Multi
Aliases: awaiting_approval

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

-BillingDate

Filter by billing date.

Type: DateTime
Parameter Sets: Multi
Aliases: billing_date

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

-BillingCategoryIds

Filter by billing category ids.

Type: Int32[]
Parameter Sets: Multi
Aliases: billingcategory_ids

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

-ClientId

Filter by the specified client id.

Type: Int32
Parameter Sets: Multi
Aliases: client_id

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

-ClientIds

Filter by the specified client ids.

Type: Int32[]
Parameter Sets: Multi
Aliases: client_ids

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

-ContractId

Filter by contract id.

Type: Int32
Parameter Sets: Multi
Aliases: contract_id

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

-Count

The number of invoices to return if not using pagination.

Type: Int32
Parameter Sets: Multi
Aliases:

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

-IdOnly

Return recurring invoice ids only.

Type: SwitchParameter
Parameter Sets: Multi
Aliases:

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

-IncludeCredits

Include credit notes

Type: SwitchParameter
Parameter Sets: Multi
Aliases:

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

-IncludeInvoices

Include invoices

Type: SwitchParameter
Parameter Sets: Multi
Aliases:

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

-IncludeLines

Include invoice lines

Type: SwitchParameter
Parameter Sets: Multi
Aliases:

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

-IncludePOInvoices

Include PO invoices.

Type: SwitchParameter
Parameter Sets: Multi
Aliases:

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

-IncludeInvoiceDateEnd

Include the field invoicedateend in the results.

Type: SwitchParameter
Parameter Sets: Multi
Aliases: invoicedateend

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

-IncludeInvoiceDateStart

Include the field invoicedatestart in the results.

Type: SwitchParameter
Parameter Sets: Multi
Aliases: invoicedatestart

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

-MyApprovals

Filter by your approvals.

Type: SwitchParameter
Parameter Sets: Multi
Aliases: my_approvals

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

-NotPostedOnly

Filter for unposted invoices only.

Type: SwitchParameter
Parameter Sets: Multi
Aliases:

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

-Order

First field to order the results by.

Type: String
Parameter Sets: Multi
Aliases:

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

-OrderDesc

Order results for the first field in descending order (respects the field choice in '-OrderBy')

Type: SwitchParameter
Parameter Sets: Multi
Aliases:

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

-Order2

Second field to order the results by.

Type: String
Parameter Sets: Multi
Aliases:

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

-OrderDesc2

Order results for the second field in descending order (respects the field choice in '-OrderBy2')

Type: SwitchParameter
Parameter Sets: Multi
Aliases:

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

-Order3

Third field to order the results by.

Type: String
Parameter Sets: Multi
Aliases:

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

-OrderDesc3

Order results for the third field in descending order (respects the field choice in '-OrderBy3')

Type: SwitchParameter
Parameter Sets: Multi
Aliases:

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

-Order4

Fourth field to order the results by.

Type: String
Parameter Sets: Multi
Aliases:

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

-OrderDesc4

Order results for the fourth field in descending order (respects the field choice in '-OrderBy4')

Type: SwitchParameter
Parameter Sets: Multi
Aliases:

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

-Order5

Fifth field to order the results by.

Type: String
Parameter Sets: Multi
Aliases:

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

-OrderDesc5

Order results for the fifth field in descending order (respects the field choice in '-OrderBy5')

Type: SwitchParameter
Parameter Sets: Multi
Aliases:

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

-PageNo

Which page to return.

Type: Int32
Parameter Sets: Multi
Aliases: page_no

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

-PageSize

Number of results per page.

Type: Int32
Parameter Sets: Multi
Aliases: page_size

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

-Paginate

Paginate results

Type: SwitchParameter
Parameter Sets: Multi
Aliases: pageinate

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

-PaymentStatuses

Filter by the specified payment statuses.

Type: Int32[]
Parameter Sets: Multi
Aliases:

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

-PostedOnly

Include posted invoices only.

Type: SwitchParameter
Parameter Sets: Multi
Aliases:

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

-PurchaseOrderId

Filter by the specified purchase order id.

Type: Int32
Parameter Sets: Multi
Aliases: purchaseorder_id

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

-QuoteStatuses

Filter by the specified quote statuses.

Type: String[]
Parameter Sets: Multi
Aliases: quote_status

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

-ReadyForInvoicing

Filter by whether the recurring invoice is marked 'ready for invoicing'.

Type: SwitchParameter
Parameter Sets: Multi
Aliases: ready_for_invoicing

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

-ReviewRequired

Filter for invoices marked 'review required'.

Type: SwitchParameter
Parameter Sets: Multi
Aliases:

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

-RecurringInvoiceType

Filter by recurring invoice type. Valid values are 'contracts', 'invoices' or 'both'.

Type: String
Parameter Sets: Multi
Aliases: rinvoice_type

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

-SalesOrderId

Filter by contract sales order id.

Type: Int32
Parameter Sets: Multi
Aliases: salesorder_id

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

Filter using the specified search query.

Type: String
Parameter Sets: Multi
Aliases:

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

-SentStatus

Filter by sent status.

Type: Int32
Parameter Sets: Multi
Aliases: sent_status

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

-SiteId

Filter by the specified site id.

Type: Int32
Parameter Sets: Multi
Aliases: site_id

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

-StripeAutoPaymentRequired

Filter by invoices requiring stripe payment.

Type: SwitchParameter
Parameter Sets: Multi
Aliases:

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

-TicketId

Filter by the specified ticket id.

Type: Int32
Parameter Sets: Multi
Aliases: ticket_id

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

-TopLevelId

Filter by the specified top level id.

Type: Int32
Parameter Sets: Multi
Aliases: toplevel_id

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

-UserId

Filter by the specified user ID.

Type: Int32
Parameter Sets: Multi
Aliases: user_id

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

-FullObjects

Parameter to return the complete objects.

Type: SwitchParameter
Parameter Sets: Multi
Aliases:

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

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

A powershell object containing the response.

NOTES