Add-BT_Team

Syntax

Add-BT_Team -Ticket <Ticket> [-Environment <string>] [-Id <guid>] [-IsDeleted <bool>] [-Created <datetime>] [-Updated <datetime>] [-Version <int>] [-CreatedBySystemUserId <guid>] [-WorkgroupOrganizationId <guid>] [-Name <string>] [-AssignmentType <AssignmentType>] [-AccessLevel <AccessLevel>] [<CommonParameters>]

Add-BT_Team -Ticket <Ticket> -EndpointUrl <string> [-Id <guid>] [-IsDeleted <bool>] [-Created <datetime>] [-Updated <datetime>] [-Version <int>] [-CreatedBySystemUserId <guid>] [-WorkgroupOrganizationId <guid>] [-Name <string>] [-AssignmentType <AssignmentType>] [-AccessLevel <AccessLevel>] [<CommonParameters>]

Detailed Description

Add-BT_Team adds a(an) BT_Team. Represents an MSPC team. A team is a set of workgroup members who can be assigned to an MSPComplete task or service.

Parameters

Total Parameters: 24

EndpointUrl

Paremeter specs:

Required True
ValueFromPipeline False
ValueFromPipelineByPropertyName False

Ticket

Paremeter specs:

Required True
ValueFromPipeline False
ValueFromPipelineByPropertyName False

AccessLevel

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

AssignmentType

Available values are listed below.

Value Description
PullFromQueue The agents pull the task from the queue.
LeastLoad Automatically assign the task to the agent with the least load.
RoundRobin Automatically assign the task to the users in turn.

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

Created

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

CreatedBySystemUserId

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

Id

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

IsDeleted

Paremeter specs:

Required False
ValueFromPipeline False
ValueFromPipelineByPropertyName False

Name

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

Ticket requirement

Teams are under workgroups, thus a ticket scoped to a workgroup is required.


Assigment type

MSPComplete defines two methods for assigning tasks to team members:

Pull from Queue (PullFromQueue). The task is assigned to the team, and any team member can claim the task on the My Tasks page. Before the service starts, MSPComplete notifies you if the team task has not been claimed by any of the team members.

Load Balance (LeastLoad). MSPComplete automatically assigns the task to the team member who has the fewest assigned tasks. The schedule and duration of the assigned tasks are not considered.


Examples

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

$workgroups = Get-BT_Workgroup -Ticket $btTicket -Name "Default"

$workgroupTicket = Get-BT_Ticket -Ticket $btTicket -OrganizationId $workgroups[0].WorkgroupOrganizationId

$team = Add-BT_Team -Ticket $workgroupTicket -Name "My new team" -AssignmentType LeastLoad