New-MgBookingBusiness

What is New-MgBookingBusiness?

The New-MgBookingBusiness cmdlet is used to create a new Microsoft Bookings business entity within Microsoft 365. Each Booking Business acts as a centralized location for managing appointments, services, customers, and staff—ideal for organizations providing professional or customer-facing services.

Why Use New-MgBookingBusiness?

Administrators and service managers use this cmdlet to:

• Create new business booking pages for departments, clinics, or service centers.
• Automate the onboarding process for multiple service branches.
• Maintain consistent business hours, contact details, and branding across multiple entities.
• Simplify scheduling and appointment management using Microsoft Bookings through Graph automation.

By leveraging Graph PowerShell, businesses can efficiently deploy and configure multiple booking entities without relying on manual setup through the Microsoft 365 admin center.

Prerequisites

Before running this cmdlet, ensure you are connected to Microsoft Graph with the correct permissions:

Install-Module Microsoft.Graph -Scope CurrentUser
Connect-MgGraph -Scopes "Bookings.ReadWrite.All"
                                        

How to Use New-MgBookingBusiness?

To create a new Booking Business, use the -BodyParameter parameter to pass a hashtable containing required fields such as display name, address, and contact information.

New-MgBookingBusiness -BodyParameter <IMicrosoftGraphBookingBusiness>

New-MgBookingBusiness Examples

Example 1: Single Booking Business Creation

Creating a single business booking page is straightforward. The following example demonstrates how to create a new business booking page using the required properties:

$body = @{
    DisplayName = "Contoso Health Clinic"
    BusinessHours = @{
        Day = "Monday"
        StartTime = "08:00:00"
        EndTime = "17:00:00"
    }
    Address = @{
        Street = "123 Main St"
        City = "Redmond"
        State = "WA"
        PostalCode = "98052"
        CountryOrRegion = "US"
    }
    Phone = "+1 425-555-0100"
    Email = "contact@contosohealthclinic.com"
    WebSiteUrl = "https://contosohealthclinic.com"
}

New-MgBookingBusiness -BodyParameter $body

This example creates a new Booking Business named Contoso Health Clinic with its contact details and working hours configured.

Example 2: Multiple Booking Businesses Creation

To create multiple business booking pages, loop through an array of hashtables, each representing a separate business or branch.

$businesses = @(
    @{
        DisplayName = "Contoso Health Clinic"
        BusinessHours = @{
            Day = "Monday"
            StartTime = "08:00:00"
            EndTime = "17:00:00"
        }
        Address = @{
            Street = "123 Main St"
            City = "Redmond"
            State = "WA"
            PostalCode = "98052"
            CountryOrRegion = "US"
        }
        Phone = "+1 425-555-0100"
        Email = "contact@contosohealthclinic.com"
        WebSiteUrl = "https://contosohealthclinic.com"
    }
    @{
        DisplayName = "Contoso Dental Clinic"
        BusinessHours = @{
            Day = "Tuesday"
            StartTime = "09:00:00"
            EndTime = "18:00:00"
        }
        Address = @{
            Street = "456 Second St"
            City = "Bellevue"
            State = "WA"
            PostalCode = "98007"
            CountryOrRegion = "US"
        }
        Phone = "+1 425-555-0200"
        Email = "contact@contosodentalclinic.com"
        WebSiteUrl = "https://contosodentalclinic.com"
    }
)

foreach ($business in $businesses) {
    New-MgBookingBusiness -BodyParameter $business
}

This script automates the creation of multiple Booking Businesses, reducing setup time for organizations with multiple service locations.

Example 3: Bulk Creation Using CSV

For larger organizations, you can bulk-create Booking Businesses using data from a CSV file.

CSV File Structure:

DisplayName,Day,StartTime,EndTime,Street,City,State,PostalCode,CountryOrRegion,Phone,Email,WebSiteUrl
Contoso Health Clinic,Monday,08:00:00,17:00:00,123 Main St,Redmond,WA,98052,US,+1 425-555-0100,contact@contosohealthclinic.com,https://contosohealthclinic.com
Contoso Dental Clinic,Tuesday,09:00:00,18:00:00,456 Second St,Bellevue,WA,98007,US,+1 425-555-0200,contact@contosodentalclinic.com,https://contosodentalclinic.com
Contoso Spa,Wednesday,10:00:00,19:00:00,789 Third St,Kirkland,WA,98033,US,+1 425-555-0300,contact@contosospaclub.com,https://contosospaclub.com
                                        

PowerShell Script:

$csv = Import-Csv -Path "C:\BookingBusinesses.csv"
foreach ($row in $csv) {
    $body = @{
        DisplayName = $row.DisplayName
        BusinessHours = @{
            Day = $row.Day
            StartTime = $row.StartTime
            EndTime = $row.EndTime
        }
        Address = @{
            Street = $row.Street
            City = $row.City
            State = $row.State
            PostalCode = $row.PostalCode
            CountryOrRegion = $row.CountryOrRegion
        }
        Phone = $row.Phone
        Email = $row.Email
        WebSiteUrl = $row.WebSiteUrl
    }
    New-MgBookingBusiness -BodyParameter $body
}

This approach streamlines bulk Booking Business creation for enterprises managing multiple departments or regional offices.

Summary

Key Point	Details
Cmdlet Name	New-MgBookingBusiness
Purpose	Creates a new Microsoft Bookings business entity within Microsoft 365
Required Scope	Bookings.ReadWrite.All
Primary Parameter	BodyParameter
Automation Benefit	Enables mass creation and configuration of Booking Businesses
Use Case	Useful for organizations offering services across multiple branches or regions