How to Configure Teams Virtual Appointments Policies in PowerShell Using CsTeamsVirtualAppointmentsPolicy

Modern enterprise organisations across healthcare, financial advisory, and customer service sectors rely on Microsoft Teams to manage business-to-consumer (B2C) consultations. Through the Virtual Appointments application and Teams Premium integration, organisations conduct virtual visits with external clients without requiring attendees to install the Teams desktop app or create a Microsoft account. To govern access to advanced appointment management capabilities—such as SMS notifications, mobile browser join experiences, custom waiting rooms, and post-appointment analytics—administrators utilize the Microsoft Teams PowerShell module. Specifically, the CsTeamsVirtualAppointmentsPolicy cmdlets allow IT administrators to define, assign, and audit granular virtual appointment controls across global tenants and designated departments.

Understanding Teams Virtual Appointments Policy Capabilities

The CsTeamsVirtualAppointmentsPolicy cmdlet family governs the feature matrix available to organisers scheduling meetings via the Virtual Appointments app or Microsoft Bookings integration. Key parameters managed under this policy framework include:

  • EnableOnlineAppointment: Controls whether users can schedule virtual appointments with external attendees.
  • EnableFormsIntegration: Dictates whether pre-consultation digital triage forms (created in Microsoft Forms) can be attached to the appointment booking flow.
  • EnableAnalytics: Governs user access to aggregate and individual appointment analytics, including attendance rates, wait times, and appointment durations.
  • EnableSmsNotifications: Manages whether SMS confirmation and reminder messages can be dispatched to attendees’ mobile phone numbers (subject to tenant licensing and telephony credits).

Connecting to the Microsoft Teams PowerShell Module

Before configuring virtual appointment policies, verify that the modern Microsoft Teams PowerShell module (version 5.0 or later) is installed on your management workstation.

Open Windows PowerShell or PowerShell 7 as an Administrator, and connect to your Microsoft 365 tenant using privileged credentials:

Connect-MicrosoftTeams

Complete multi-factor authentication (MFA) prompts. Once authenticated, verify your active tenant session and account identity:

Get-CsTenant | Select-Object DisplayName, TenantId

Auditing Existing Virtual Appointments Policies

By default, Microsoft Teams includes a pre-configured Global (Org-wide default) policy. To inspect all virtual appointments policies defined in the tenant, run:

Get-CsTeamsVirtualAppointmentsPolicy

To inspect the specific parameter settings applied by the Global policy, target its identity directly:

Get-CsTeamsVirtualAppointmentsPolicy -Identity Global | Format-List Identity, EnableOnlineAppointment, EnableFormsIntegration, EnableAnalytics, EnableSmsNotifications

PowerShell outputs the policy values governing standard tenant users:

Identity                 : Global
EnableOnlineAppointment  : True
EnableFormsIntegration   : True
EnableAnalytics          : True
EnableSmsNotifications   : False

Creating a Custom Virtual Appointments Policy

In many enterprise governance models, specialized departments such as clinical telehealth staff or wealth management advisors require advanced capabilities (such as SMS reminders and analytics), while general staff should remain restricted.

Use the New-CsTeamsVirtualAppointmentsPolicy cmdlet to create a custom policy instance:

New-CsTeamsVirtualAppointmentsPolicy -Identity "Telehealth-Clinicians" -EnableOnlineAppointment $true -EnableFormsIntegration $true -EnableAnalytics $true -EnableSmsNotifications $true -Description "Policy granting full virtual appointment capabilities with SMS reminders to telehealth clinical staff."

To create a restricted policy for standard front-office personnel that prevents external appointment creation entirely, run:

New-CsTeamsVirtualAppointmentsPolicy -Identity "FrontDesk-Restricted" -EnableOnlineAppointment $false -EnableFormsIntegration $false -EnableAnalytics $false -Description "Restricts external virtual appointment scheduling."

Modifying Existing Policy Settings

If compliance guidelines or licensing agreements change, you can update existing custom policies or the Global tenant policy using Set-CsTeamsVirtualAppointmentsPolicy.

For example, to enable SMS reminders globally across the entire organization once licensing credits are allocated:

Set-CsTeamsVirtualAppointmentsPolicy -Identity Global -EnableSmsNotifications $true

To disable analytics reporting on a custom departmental policy:

Set-CsTeamsVirtualAppointmentsPolicy -Identity "Telehealth-Clinicians" -EnableAnalytics $false

Assigning Policies to Individual Users and Security Groups

After creating custom policies, you can assign them to target users or security groups using the Grant-CsTeamsVirtualAppointmentsPolicy cmdlet.

To assign the specialized policy directly to an individual user via User Principal Name (UPN):

Grant-CsTeamsVirtualAppointmentsPolicy -Identity "[email protected]" -PolicyName "Telehealth-Clinicians"

To remove an explicit individual policy assignment and return the user to the Global organizational default, pass $null:

Grant-CsTeamsVirtualAppointmentsPolicy -Identity "[email protected]" -PolicyName $null

For enterprise-scale management, assign policies based on Microsoft 365 Security Group membership using group policy assignment:

New-CsGroupPolicyAssignment -GroupId "b2a3c4d5-e6f7-8901-abcd-ef0123456789" -PolicyType TeamsVirtualAppointmentsPolicy -PolicyName "Telehealth-Clinicians" -Rank 1

Verifying Effective User Policy Assignments

To verify the effective virtual appointments policy applied to a specific user, query the user calling and meeting settings:

Get-CsUserPolicyAssignment -Identity "[email protected]" -PolicyType TeamsVirtualAppointmentsPolicy

PowerShell outputs the policy identity along with assignment details:

PolicyType                    PolicyName            AssignmentType
----------                    ----------            --------------
TeamsVirtualAppointmentsPolicy Telehealth-Clinicians Direct

Policy changes propagate across Microsoft Teams infrastructure within 15 to 30 minutes, after which end users will observe the updated feature controls within the Teams client and web apps.

Get the best tech tips delivered straight to your inbox.

Join thousands of readers mastering Apple, Google, Microsoft, and Linux.