Commands › Microsoft Teams

Set-CsOnlineVoiceUser

Microsoft Teams MicrosoftTeams Set-*

Set the PSTN specific parameters (like telephone numbers and emergency response locations.)

Quick start script

# Set-CsOnlineVoiceUser — 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-CsOnlineVoiceUser
$before | Format-List

# 3. Make the change (dry run first)
Set-CsOnlineVoiceUser  -WhatIf
Set-CsOnlineVoiceUser

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

Syntax

Set-CsOnlineVoiceUser [-Identity] <UserIdParameter> [-Tenant <Guid>] [-TelephoneNumber <String>]
 [-LocationID <Guid>] [-DomainController <Fqdn>] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]

Parameters (8)

Parameter	Type	What it controls
-Confirm	SwitchParameter	The Confirm switch causes the command to pause processing and requires confirmation to proceed.
-DomainController	Fqdn	This parameter is reserved for internal Microsoft use.
-Force	SwitchParameter	The Force switch specifies whether to suppress warning and confirmation messages. It can be useful in scripting to suppress interactive prompts. If the Force switch isn't provided in the command, you're prompted for...
-Identity	Object	Specifies the identity of the target user. Acceptable values include:
-LocationID	Guid	Specifies the unique identifier of the emergency location to assign to the user. Location identities can be discovered by using the `Get-CsOnlineLisLocation` cmdlet.
-TelephoneNumber	String	Specifies the telephone number to be assigned to the user. The value must be in E.164 format: +14255043920. Setting the value to $Null clears the user's telephone number.
-Tenant	Guid	This parameter is reserved for internal Microsoft use.
-WhatIf	SwitchParameter	The WhatIf parameter is not implemented for this cmdlet.

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