Commands › Microsoft Teams

New-CsTeamsEmergencyCallingPolicy

Microsoft Teams MicrosoftTeams New-*

Quick start script

# New-CsTeamsEmergencyCallingPolicy — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-MicrosoftTeams -CertificateThumbprint $thumb -ApplicationId $appId -TenantId $tenantId

# 2. Capture the current state first — you cannot roll back what you never recorded
$before = Get-CsTeamsEmergencyCallingPolicy
$before | Format-List

# 3. Make the change (dry run first)
New-CsTeamsEmergencyCallingPolicy -Identity <String> -WhatIf
New-CsTeamsEmergencyCallingPolicy -Identity <String>

# 4. Verify and diff
$after = Get-CsTeamsEmergencyCallingPolicy
Compare-Object ($before | Out-String) ($after | Out-String)

Syntax

New-CsTeamsEmergencyCallingPolicy [-Identity] <string> [-ExtendedNotifications <PSListModifier[TeamsEmergencyCallingExtendedNotification]>]
 [-NotificationGroup <string>] [-NotificationDialOutNumber <string>] [-ExternalLocationLookupMode <ExternalLocationLookupMode>]
 [-NotificationMode <NotificationMode>] [-EnhancedEmergencyServiceDisclaimer <string>] [-Description <string>] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]

Parameters (10)

ParameterTypeRequiredWhat it controls
-Confirm SwitchParameter Prompts you for confirmation before running the cmdlet.
-Description String The Description parameter describes the Teams Emergency Calling policy - what it is for, what type of user it applies to and any other information that helps to identify the purpose of this policy. Maximum characters: 512.
-EnhancedEmergencyServiceDisclaimer String Allows the tenant administrator to configure a text string, which is shown at the top of the Calls app. The user can acknowledge the string by selecting OK. The string will be shown on client restart. The disclaimer...
-ExtendedNotifications TeamsEmergencyCallingExtendedNotification] A list of one or more instances of TeamsEmergencyCallingExtendedNotification. Each TeamsEmergencyCallingExtendedNotification should use a unique EmergencyDialString.
-ExternalLocationLookupMode ExternalLocationLookupMode Enable ExternalLocationLookupMode. This mode allow users to set Emergency addresses for remote locations.
-Identity String yes The Identity parameter is a unique identifier that designates the name of the policy
-NotificationDialOutNumber String This parameter represents the PSTN number which can be dialed out if NotificationMode is set to either of the two Conference values. The PSTN phone cannot be unmuted even when the NotificationMode is set to ConferenceUnMuted.
-NotificationGroup String NotificationGroup is an email list of users and groups to be notified of an emergency call via Teams chat. Individual users or groups are separated by ";", for instance, "group1@contoso.com;group2@contoso.com". A...
-NotificationMode NotificationMode The type of conference experience for security desk notification. Possible values are NotificationOnly, ConferenceMuted, and ConferenceUnMuted.
-WhatIf SwitchParameter Shows what would happen if the cmdlet runs. The cmdlet is not run.

Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.