Commands › Microsoft Teams

Set-CsOnlineApplicationInstance

Microsoft Teams MicrosoftTeams Set-*

Updates an application instance in Microsoft Entra ID.

Quick start script

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

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

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

Syntax

Set-CsOnlineApplicationInstance [-Identity] <string> [[-OnpremPhoneNumber] <string>] [[-ApplicationId] <guid>] [[-AcsResourceId] <guid>] [[-DisplayName] <string>] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]

Parameters (8)

Parameter	Type	Required	What it controls
-AcsResourceId	Guid		The ACS Resource ID. The unique identifier assigned to an instance of Azure Communication Services within the Azure cloud infrastructure.
-ApplicationId	Guid		The application ID. The Microsoft application Auto Attendant has the ApplicationId ce933385-9390-45d1-9512-c8d228074e07 and the Microsoft application Call Queue has the ApplicationId...
-Confirm	SwitchParameter		Prompts you for confirmation before running the cmdlet.
-DisplayName	String		The display name.
-Force	SwitchParameter		This switch specifies whether to suppress warning and confirmation messages. It can be useful in scripting to suppress interactive prompts. If it isn't provided in the command, you're prompted for administrative...
-Identity	String	yes	The URI or ID of the application instance to update.
-OnpremPhoneNumber	String		Note: Using this parameter has been deprecated in commercial and GCC cloud instances. Use the new Set-CsPhoneNumberAssignment cmdlet instead.
-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.