Table of contents
TOC
Collapse the table of content
Expand the table of content

Create Item

CFreemanwa|Last Updated: 1/17/2017
|
1 Contributor

Applies To: System Center 2016 - Orchestrator

The Create Item activity is used in a runbook to create new appointment, contact group, and Email Message or task items.

The following tables list the required properties, optional properties, and published data for Create Item activities. The required and optional properties are presented according to item type: appointment, contact group, task, and email message.

Additionally, this topic describes how to create recurring appointments and tasks.

Create Item Required Properties (Appointment)

ElementDescriptionValid values
StartThe start time of the appointmentDateTime
EndThe end time of the appointmentDateTime
SubjectThe subject of the appointmentString
BodyDetails about the appointmentString

Create Item Optional Properties (Appointment)

ElementDescriptionValid values
Allow New Time ProposalIndicates whether the new time proposals are allowedTrue
False
AttachmentsList of attachments for the itemComma separated list of file paths
Body TypeContent type of bodyText
HTML
CategoriesList of categories that are associated with the appointmentComma separated list
Destination FolderAlternative destination folder of the appointmentString
Free Busy StatusThe free/busy status of the owner of the appointmentFree
Tentative
Busy
OOF
NoData
ImportanceSets the importance of the appointmentLow
Normal
High
Is All Day EventIndicates whether the appointment is an all-day eventTrue
False
Is Online MeetingIndicates whether the appointment is an online meetingTrue
False
Is Reminder SetIndicates whether a reminder is set for the appointmentTrue
False
Is Response RequestedIndicates whether responses are requestedTrue
False
LocationThe location of the appointmentString
NetShow URLThe URL of the Microsoft NetShow online meetingString
Number of OccurrencesNumber of occurrencesInteger
Optional AttendeesOptional attendees for the meetingComma separated list of e-mail addresses
RecurrenceThe recurrence pattern for the meetingDaily
Weekly
The same day each month
The same week each month
The same day each year
The same week each year
Recurrence EndsThe last occurrence of the meetingDateTime
Recurrence IntervalThe recurrence intervalInteger
Recurs On These DaysThe day(s) on which the appointment recursString
Reminder (Minutes)Defines how many minutes before the occurrence a reminder is to be triggeredInteger
Reminder Due BySets the reminder due date and time for this appointmentDateTime
Required AttendeesList of required attendeesComma separated list of email addresses
ResourcesList of resources for the meetingComma separated list
SensitivitySets the sensitivity of the appointmentNormal
Personal
Private
Confidential

Create Item Required Properties (Contact Group)

ElementDescriptionValid values
Display NameThe name of the contact groupString
MembersList of members associated with contact groupComma separated list of email addresses

Create Item Optional Properties (Contact Group)

ElementDescriptionValid values
CategoriesList of categories that are associated with the Contact GroupComma separated list
Destination FolderAlternative destination folder of the Contact GroupString

Create Item Required Properties (Task)

ElementDescriptionValid values
BodyDetails about the taskString
Due DateThe date and time that the task is dueDateTime
Start DateThe date and time that the task startsDateTime
SubjectThe subject of the taskString

Create Item Optional Properties (Task)

ElementDescriptionValid values
Actual WorkThe actual amount of work spent on the taskNumber
Billing InformationBilling information for the taskString
Body TypeIndicates whether the body is text or HTMLText
HTML
CategoriesList of categories associated with the taskComma separated list
CompaniesList of companies associated with the taskComma separated list
Complete DateThe date and time that the task was completedDateTime
ContactsList of contacts associated with the taskComma separated list
Destination FolderAlternative destination folder of the taskString
ImportanceThe importance of the item.Low
Normal
High
Is Reminder SetIndicates whether a reminder is set for the taskTrue
False
MileageThe mileage of the taskString
Number of OccurrencesNumber of occurrences for a recurring taskInteger
Percent CompleteThe completion percentage of the taskNumber
RecurrenceThe recurrence pattern for the meetingDaily
Weekly
The same day each month
The same week each month
The same day each year
The same week each year
Recurrence EndsThe last occurrence of the taskDateTime
Recurrence IntervalThe recurrence intervalInteger
Recurs On These DaysThe day(s) on which the task recursString
Reminder (Minutes)Defines how many minutes before the occurrence a reminder is to be triggeredInteger
Reminder Due ByThe date and time when the reminder is dueDateTime
SensitivitySensitivity of the taskConfidential
Normal
Personal
Private
Task StatusThe status of the taskNotStarted
InProgress
Completed
WaitingOnOthers
Deferred
Total WorkThe total amount of work spent on the taskInteger

Create Item Required Properties (E-Mail Message)

ElementDescriptionValid values
ToList of recipients of the emailComma separated list of email addresses
SubjectSubject of the emailString
BodyBody of the emailString

Create Item Optional Properties (E-Mail Message)

ElementDescriptionValid values
AttachmentsList of attachmentsComma separated list of file paths
BccList of Bcc recipients for this emailComma separated list of email addresses
Body TypeIndicates whether the body is text or HTMLText
HTML
CategoriesList of categories associated with the emailComma separated list
CcList of Cc recipients for this emailComma separated list of email addresses
Destination FolderAlternative destination folder for the sent messageString
FromWho the email came fromString
ImportanceThe importance of the emailLow
Normal
High
In Reply ToThe In-Reply-To referenceString
Is Delivery Receipt RequestedIndicates whether a delivery receipt is requestedTrue
False
Is Read Receipt RequestedIndicates whether a read receipt is requestedTrue
False
Is Response RequestedIndicates whether a response is requestedTrue
False
ReferencesReferences of the emailString
SenderThe sender of the email messageString
SensitivityThe sensitivity of the emailNormal
Personal
Private
Confidential

Create Item Published Data

ElementDescriptionValue type
IDThe ID of the item that was createdString
Item TypeThe type of the item that was created.String
Destination FolderThe folder where the item is storedString
DomainDomain the Exchange Server belongs toString
Exchange Server AddressAddress of the Exchange ServerString
Timeout (seconds)Timeout value for the Exchange Server connectionNumber
Use AutodiscoverWhether or not to use Autodiscover to check for changesBoolean
User NameUser name used to log on to the Exchange ServerString

Recurring Appointments and Tasks

The integration pack provides the ability to create recurring appointments and tasks. To setup a recurring appointment or task, perform the following steps:

  1. Add the optional Recurrence property.

  2. Select the desired recurrence pattern from one of the available options.

  3. To use a pattern other than the Daily pattern, add the optional Recurs On These Days property.

  4. Specify a value for the Recurs On These Days property according to the rules that are presented in the following table.

ElementDescription
RecurrenceRecurs On These Days
DailyNot required.
WeeklySpecify a comma separated list of day names. Full or abbreviated day names are acceptable.
For example: Saturday, Sunday or Sat, Sun.
The same day each monthNot required. The day is determined by the start date.
The same week each monthSpecify a relative index followed by a day of the week. Valid indexes include First, Second, Third, Fourth, and Last. Days of the week include Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday, Weekday, and WeekendDay.
For example: First Monday.
The same day each yearNot required. The day is determined by the start date.
The same week each yearSpecify a relative index followed by a day of the week. Valid indexes include First, Second, Third, Fourth, and Last. Days of the week include Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday, Weekday, and WeekendDay. The month is determined by the start date.
For example: First Monday

Reference

Using Runbooks in System Center 2016 - Orchestrator

© 2017 Microsoft