New-MgBetaBookingBusinessStaffMember

Module:

Microsoft.Graph.Beta.Bookings

Create a new staff member in the specified bookingBusiness.

Note

To view the v1.0 release of this cmdlet, view New-MgBookingBusinessStaffMember

Syntax

New-MgBetaBookingBusinessStaffMember
   -BookingBusinessId <String>
   [-ResponseHeadersVariable <String>]
   [-AdditionalProperties <Hashtable>]
   [-AvailabilityIsAffectedByPersonalCalendar]
   [-ColorIndex <Int32>]
   [-CreatedDateTime <DateTime>]
   [-DisplayName <String>]
   [-EmailAddress <String>]
   [-Id <String>]
   [-IsEmailNotificationEnabled]
   [-LastUpdatedDateTime <DateTime>]
   [-MembershipStatus <String>]
   [-Role <String>]
   [-TimeZone <String>]
   [-UseBusinessHours]
   [-WorkingHours <IMicrosoftGraphBookingWorkHours[]>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-MgBetaBookingBusinessStaffMember
   -BookingBusinessId <String>
   [-ResponseHeadersVariable <String>]
   [-AdditionalProperties <Hashtable>]
   [-AvailabilityIsAffectedByPersonalCalendar]
   [-ColorIndex <Int32>]
   [-CreatedDateTime <DateTime>]
   [-DisplayName <String>]
   [-EmailAddress <String>]
   [-Id <String>]
   [-IsEmailNotificationEnabled]
   [-LastUpdatedDateTime <DateTime>]
   [-MembershipStatus <String>]
   [-Role <String>]
   [-TimeZone <String>]
   [-UseBusinessHours]
   [-WorkingHours <IMicrosoftGraphBookingWorkHours[]>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-MgBetaBookingBusinessStaffMember
   -BookingBusinessId <String>
   -BodyParameter <IMicrosoftGraphBookingStaffMember>
   [-ResponseHeadersVariable <String>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-MgBetaBookingBusinessStaffMember
   -BookingBusinessId <String>
   -BodyParameter <IMicrosoftGraphBookingStaffMember>
   [-ResponseHeadersVariable <String>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-MgBetaBookingBusinessStaffMember
   -InputObject <IBookingsIdentity>
   [-ResponseHeadersVariable <String>]
   [-AdditionalProperties <Hashtable>]
   [-AvailabilityIsAffectedByPersonalCalendar]
   [-ColorIndex <Int32>]
   [-CreatedDateTime <DateTime>]
   [-DisplayName <String>]
   [-EmailAddress <String>]
   [-Id <String>]
   [-IsEmailNotificationEnabled]
   [-LastUpdatedDateTime <DateTime>]
   [-MembershipStatus <String>]
   [-Role <String>]
   [-TimeZone <String>]
   [-UseBusinessHours]
   [-WorkingHours <IMicrosoftGraphBookingWorkHours[]>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-MgBetaBookingBusinessStaffMember
   -InputObject <IBookingsIdentity>
   [-ResponseHeadersVariable <String>]
   [-AdditionalProperties <Hashtable>]
   [-AvailabilityIsAffectedByPersonalCalendar]
   [-ColorIndex <Int32>]
   [-CreatedDateTime <DateTime>]
   [-DisplayName <String>]
   [-EmailAddress <String>]
   [-Id <String>]
   [-IsEmailNotificationEnabled]
   [-LastUpdatedDateTime <DateTime>]
   [-MembershipStatus <String>]
   [-Role <String>]
   [-TimeZone <String>]
   [-UseBusinessHours]
   [-WorkingHours <IMicrosoftGraphBookingWorkHours[]>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-MgBetaBookingBusinessStaffMember
   -InputObject <IBookingsIdentity>
   -BodyParameter <IMicrosoftGraphBookingStaffMember>
   [-ResponseHeadersVariable <String>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-MgBetaBookingBusinessStaffMember
   -InputObject <IBookingsIdentity>
   -BodyParameter <IMicrosoftGraphBookingStaffMember>
   [-ResponseHeadersVariable <String>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Create a new staff member in the specified bookingBusiness.

Examples

Example 1: Using the New-MgBetaBookingBusinessStaffMember Cmdlet

Import-Module Microsoft.Graph.Beta.Bookings
$params = @{
	"@odata.type" = "#microsoft.graph.bookingStaffMember"
	ColorIndex = 1
	DisplayName = "Dana Swope"
	EmailAddress = "danas@contoso.com"
	"Role@odata.type" = "#microsoft.graph.bookingStaffRole"
	Role = "externalGuest"
	TimeZone = "America/Chicago"
	UseBusinessHours = $true
	"WorkingHours@odata.type" = "#Collection(microsoft.graph.bookingWorkHours)"
	WorkingHours = @(
		@{
			"@odata.type" = "#microsoft.graph.bookingWorkHours"
			"Day@odata.type" = "#microsoft.graph.dayOfWeek"
			Day = "monday"
			"TimeSlots@odata.type" = "#Collection(microsoft.graph.bookingWorkTimeSlot)"
			TimeSlots = @(
				@{
					"@odata.type" = "#microsoft.graph.bookingWorkTimeSlot"
					End = "17:00:00.0000000"
					Start = "08:00:00.0000000"
				}
			)
		}
		@{
			"@odata.type" = "#microsoft.graph.bookingWorkHours"
			"Day@odata.type" = "#microsoft.graph.dayOfWeek"
			Day = "tuesday"
			"TimeSlots@odata.type" = "#Collection(microsoft.graph.bookingWorkTimeSlot)"
			TimeSlots = @(
				@{
					"@odata.type" = "#microsoft.graph.bookingWorkTimeSlot"
					End = "17:00:00.0000000"
					Start = "08:00:00.0000000"
				}
			)
		}
		@{
			"@odata.type" = "#microsoft.graph.bookingWorkHours"
			"Day@odata.type" = "#microsoft.graph.dayOfWeek"
			Day = "wednesday"
			"TimeSlots@odata.type" = "#Collection(microsoft.graph.bookingWorkTimeSlot)"
			TimeSlots = @(
				@{
					"@odata.type" = "#microsoft.graph.bookingWorkTimeSlot"
					End = "17:00:00.0000000"
					Start = "08:00:00.0000000"
				}
			)
		}
		@{
			"@odata.type" = "#microsoft.graph.bookingWorkHours"
			"Day@odata.type" = "#microsoft.graph.dayOfWeek"
			Day = "thursday"
			"TimeSlots@odata.type" = "#Collection(microsoft.graph.bookingWorkTimeSlot)"
			TimeSlots = @(
				@{
					"@odata.type" = "#microsoft.graph.bookingWorkTimeSlot"
					End = "17:00:00.0000000"
					Start = "08:00:00.0000000"
				}
			)
		}
		@{
			"@odata.type" = "#microsoft.graph.bookingWorkHours"
			"Day@odata.type" = "#microsoft.graph.dayOfWeek"
			Day = "friday"
			"TimeSlots@odata.type" = "#Collection(microsoft.graph.bookingWorkTimeSlot)"
			TimeSlots = @(
				@{
					"@odata.type" = "#microsoft.graph.bookingWorkTimeSlot"
					End = "17:00:00.0000000"
					Start = "08:00:00.0000000"
				}
			)
		}
	)
	IsEmailNotificationEnabled = $false
}
New-MgBetaBookingBusinessStaffMember -BookingBusinessId $bookingBusinessId -BodyParameter $params

This example shows how to use the New-MgBetaBookingBusinessStaffMember Cmdlet. To learn about permissions for this resource, see the permissions reference.

Parameters

-AdditionalProperties

Additional Parameters

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

-AvailabilityIsAffectedByPersonalCalendar

True means that if the staff member is a Microsoft 365 user, the Bookings API would verify the staff member's availability in their personal calendar in Microsoft 365, before making a booking.

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

-BodyParameter

Represents a staff member who provides services in a business. To construct, see NOTES section for BODYPARAMETER properties and create a hash table.

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

-BookingBusinessId

The unique identifier of bookingBusiness

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

-ColorIndex

Identifies a color to represent the staff member. The color corresponds to the color palette in the Staff details page in the Bookings app.

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

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CreatedDateTime

The date, time and timezone when the staff member was created.

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

-DisplayName

A name for the derived entity, which interfaces with customers.

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

-EmailAddress

The email address of the person.

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

-Headers

Optional headers that will be added to the request.

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

-Id

The unique identifier for an entity. Read-only.

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

-InputObject

Identity Parameter To construct, see NOTES section for INPUTOBJECT properties and create a hash table.

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

-IsEmailNotificationEnabled

Indicates that a staff members are notified via email when a booking assigned to them is created or changed. The default value is true

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

-LastUpdatedDateTime

The date, time and timezone when the staff member was last updated.

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

-MembershipStatus

bookingStaffMembershipStatus

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

-ProgressAction

{{ Fill ProgressAction Description }}

Type:	ActionPreference
Aliases:	proga
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResponseHeadersVariable

Optional Response Headers Variable.

Type:	String
Aliases:	RHV
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Role

bookingStaffRole

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

-TimeZone

The time zone of the staff member. For a list of possible values, see dateTimeTimeZone.

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

-UseBusinessHours

True means the staff member's availability is as specified in the businessHours property of the business. False means the availability is determined by the staff member's workingHours property setting.

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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WorkingHours

The range of hours each day of the week that the staff member is available for booking. By default, they're initialized to be the same as the businessHours property of the business. To construct, see NOTES section for WORKINGHOURS properties and create a hash table.

Type:	IMicrosoftGraphBookingWorkHours[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Inputs

Microsoft.Graph.Beta.PowerShell.Models.IBookingsIdentity

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphBookingStaffMember

System.Collections.IDictionary

Outputs

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphBookingStaffMember

Notes

COMPLEX PARAMETER PROPERTIES

To create the parameters described below, construct a hash table containing the appropriate properties. For information on hash tables, run Get-Help about_Hash_Tables.

BODYPARAMETER <IMicrosoftGraphBookingStaffMember>: Represents a staff member who provides services in a business.

• [(Any) <Object>]: This indicates any property can be added to this object.
• [EmailAddress <String>]: The email address of the person.
• [DisplayName <String>]: A name for the derived entity, which interfaces with customers.
• [Id <String>]: The unique identifier for an entity. Read-only.
• [AvailabilityIsAffectedByPersonalCalendar <Boolean?>]: True means that if the staff member is a Microsoft 365 user, the Bookings API would verify the staff member's availability in their personal calendar in Microsoft 365, before making a booking.
• [ColorIndex <Int32?>]: Identifies a color to represent the staff member. The color corresponds to the color palette in the Staff details page in the Bookings app.
• [CreatedDateTime <DateTime?>]: The date, time and timezone when the staff member was created.
• [IsEmailNotificationEnabled <Boolean?>]: Indicates that a staff members are notified via email when a booking assigned to them is created or changed. The default value is true
• [LastUpdatedDateTime <DateTime?>]: The date, time and timezone when the staff member was last updated.
• [MembershipStatus <String>]: bookingStaffMembershipStatus
• [Role <String>]: bookingStaffRole
• [TimeZone <String>]: The time zone of the staff member. For a list of possible values, see dateTimeTimeZone.
• [UseBusinessHours <Boolean?>]: True means the staff member's availability is as specified in the businessHours property of the business. False means the availability is determined by the staff member's workingHours property setting.
• [WorkingHours <IMicrosoftGraphBookingWorkHours- []>]: The range of hours each day of the week that the staff member is available for booking. By default, they're initialized to be the same as the businessHours property of the business.
  • [Day <String>]: dayOfWeek
  • [TimeSlots <IMicrosoftGraphBookingWorkTimeSlot- []>]: A list of start/end times during a day.
    • [End <String>]: The time of the day when work stops. For example, 17:00:00.0000000.
    • [Start <String>]: The time of the day when work starts. For example, 08:00:00.0000000.

INPUTOBJECT <IBookingsIdentity>: Identity Parameter

• [AttendanceRecordId <String>]: The unique identifier of attendanceRecord
• [BookingAppointmentId <String>]: The unique identifier of bookingAppointment
• [BookingBusinessId <String>]: The unique identifier of bookingBusiness
• [BookingCurrencyId <String>]: The unique identifier of bookingCurrency
• [BookingCustomQuestionId <String>]: The unique identifier of bookingCustomQuestion
• [BookingCustomerId <String>]: The unique identifier of bookingCustomer
• [BookingServiceId <String>]: The unique identifier of bookingService
• [BookingStaffMemberId <String>]: The unique identifier of bookingStaffMember
• [BusinessScenarioId <String>]: The unique identifier of businessScenario
• [BusinessScenarioTaskId <String>]: The unique identifier of businessScenarioTask
• [Email <String>]: Alternate key of virtualEventRegistration
• [JoinWebUrl <String>]: Alternate key of virtualEventSession
• [MeetingAttendanceReportId <String>]: The unique identifier of meetingAttendanceReport
• [PlannerPlanConfigurationLocalizationId <String>]: The unique identifier of plannerPlanConfigurationLocalization
• [Role <String>]: Usage: role='{role}'
• [UniqueName <String>]: Alternate key of businessScenario
• [UserId <String>]: Alternate key of virtualEventRegistration
• [VirtualEventId <String>]: The unique identifier of virtualEvent
• [VirtualEventPresenterId <String>]: The unique identifier of virtualEventPresenter
• [VirtualEventRegistrationId <String>]: The unique identifier of virtualEventRegistration
• [VirtualEventSessionId <String>]: The unique identifier of virtualEventSession
• [VirtualEventTownhallId <String>]: The unique identifier of virtualEventTownhall
• [VirtualEventWebinarId <String>]: The unique identifier of virtualEventWebinar

WORKINGHOURS <IMicrosoftGraphBookingWorkHours- []>: The range of hours each day of the week that the staff member is available for booking. By default, they're initialized to be the same as the businessHours property of the business.

• [Day <String>]: dayOfWeek
• [TimeSlots <IMicrosoftGraphBookingWorkTimeSlot- []>]: A list of start/end times during a day.
  • [End <String>]: The time of the day when work stops. For example, 17:00:00.0000000.
  • [Start <String>]: The time of the day when work starts. For example, 08:00:00.0000000.

Related Links

• https://learn.microsoft.com/powershell/module/microsoft.graph.beta.bookings/new-mgbetabookingbusinessstaffmember
• https://learn.microsoft.com/graph/api/bookingbusiness-post-staffmembers?view=graph-rest-1.0