Get-MgBookingBusinessStaffMember

What is Get-MgBookingBusinessStaffMember?

Get-MgBookingBusinessStaffMember is a Microsoft Graph PowerShell cmdlet used to retrieve staff members associated with a Microsoft Bookings Business. It returns details such as display name, email address, and staff role by reading the booking staff profiles stored in Microsoft 365.

Why Use Get-MgBookingBusinessStaffMember?

This cmdlet helps administrators:

• Audit and review all staff linked to a booking business
• Verify staff assignments and roles
• Integrate staff data into reporting or automation
• Manage Bookings environments efficiently at scale

It is especially useful when working with multiple locations or service-based teams.

Prerequisites

Before running the cmdlet, install and connect to Microsoft Graph:

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

How to Use Get-MgBookingBusinessStaffMember?

Use the cmdlet with the Booking Business ID, and optionally specify a staff member ID:

Get-MgBookingBusinessStaffMember -BookingBusinessId <String> [-BookingStaffMemberBaseId <String>]

Get-MgBookingBusinessStaffMember Examples

Example 1: Get All Staff Members in a Booking Business

$staffMembers = Get-MgBookingBusinessStaffMember -BookingBusinessId "your-booking-business-id"
foreach ($member in $staffMembers) {
    $memberDetails = $member.AdditionalProperties
    [PSCustomObject]@{
        Id          = $member.Id
        DisplayName = $memberDetails.displayName
        Email       = $memberDetails.emailAddress
        Role        = $memberDetails.role
    }
}
                                        

This retrieves all staff members associated with the specified Booking Business.

Example 2: Get a Single Staff Member by ID

$staffMember = Get-MgBookingBusinessStaffMember -BookingBusinessId "your-booking-business-id" -BookingStaffMemberBaseId "staff-member-id"
$memberDetails = $staffMember.AdditionalProperties
[PSCustomObject]@{
    Id          = $staffMember.Id
    DisplayName = $memberDetails.displayName
    Email       = $memberDetails.emailAddress
    Role        = $memberDetails.role
}
                                        

Use this to retrieve details for a specific staff member using their unique staff ID.

Summary

Key Point	Details
Cmdlet Name	Get-MgBookingBusinessStaffMember
Purpose	Retrieves staff details for a Microsoft Bookings Business
Required Scope	Bookings.Read.All
Primary Parameters	BookingBusinessId, BookingStaffMemberBaseId
Automation Benefit	Enables bulk reporting, staff auditing, and service-team automation
Use Case	Managing staff assignments across Bookings locations or service units