From f56d8705093860d2ff4d2d223837f26cdcfe32f4 Mon Sep 17 00:00:00 2001
From: Gilberth Arce <gilbertharce@microsoft.com>
Date: Wed, 10 Dec 2025 14:48:36 -0600
Subject: [PATCH] Cmdlet Docu

---
 .../Get-CsEffectiveTenantDialPlan.md          | 28 ++++++++++++++++++-
 .../Test-CsEffectiveTenantDialPlan.md         | 27 ++++++++++++++++--
 2 files changed, 52 insertions(+), 3 deletions(-)

diff --git a/teams/teams-ps/MicrosoftTeams/Get-CsEffectiveTenantDialPlan.md b/teams/teams-ps/MicrosoftTeams/Get-CsEffectiveTenantDialPlan.md
index 711d8ec146..e30feb16a1 100644
--- a/teams/teams-ps/MicrosoftTeams/Get-CsEffectiveTenantDialPlan.md
+++ b/teams/teams-ps/MicrosoftTeams/Get-CsEffectiveTenantDialPlan.md
@@ -19,7 +19,7 @@ Use the Get-CsEffectiveTenantDialPlan cmdlet to retrieve an effective tenant dia
 ## SYNTAX
 
 ```
-Get-CsEffectiveTenantDialPlan [-Identity] <UserIdParameter> [-OU <OUIdParameter>] [-ResultSize <Int32>] [-WhatIf] [-Confirm] [<CommonParameters>]
+Get-CsEffectiveTenantDialPlan [-Identity] <UserIdParameter> [-CallerNumber] <CallerNumber> [-OU <OUIdParameter>] [-ResultSize <Int32>] [-WhatIf] [-Confirm] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
@@ -36,6 +36,14 @@ Get-CsEffectiveTenantDialPlan -Identity Vt1_User1
 
 This example gets the effective tenant dial plan for the Vt1_User1.
 
+### -------------------------- Example 2 --------------------------
+```
+Get-CsEffectiveTenantDialPlan -Identity Vt1_User1 -CallerNumber 1234567890
+```
+
+This example gets the effective tenant dial plan assigned to the phone number 1234567890 for the Vt1_User1.
+
+
 ## PARAMETERS
 
 ### -Confirm
@@ -74,6 +82,24 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -CallerNumber
+
+> Applicable: Microsoft Teams
+
+The Caller Number parameter is the phone number assigned to the user for whom to retrieve the effective tenant dial plan.
+
+```yaml
+Type: PhoneNumber
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -OU
 
 > Applicable: Microsoft Teams
diff --git a/teams/teams-ps/MicrosoftTeams/Test-CsEffectiveTenantDialPlan.md b/teams/teams-ps/MicrosoftTeams/Test-CsEffectiveTenantDialPlan.md
index 7f9be8612c..be6a6a98d4 100644
--- a/teams/teams-ps/MicrosoftTeams/Test-CsEffectiveTenantDialPlan.md
+++ b/teams/teams-ps/MicrosoftTeams/Test-CsEffectiveTenantDialPlan.md
@@ -21,13 +21,13 @@ Use the Test-CsEffectiveTenantDialPlan cmdlet to test a tenant dial plan.
 
 ### Identity
 ```
-Test-CsEffectiveTenantDialPlan [-DialedNumber <PhoneNumber>] [-Identity <UserIdParameter>] [-TenantScopeOnly]
+Test-CsEffectiveTenantDialPlan [-DialedNumber <PhoneNumber>] [-CallerNumber <CallerNumber>] [-Identity <UserIdParameter>] [-TenantScopeOnly]
  [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]
 ```
 
 ### EffectiveTDPName
 ```
-Test-CsEffectiveTenantDialPlan -DialedNumber <PhoneNumber> [-EffectiveTenantDialPlanName <String>]
+Test-CsEffectiveTenantDialPlan -DialedNumber <PhoneNumber> [-CallerNumber <CallerNumber>] [-EffectiveTenantDialPlanName <String>]
  [-TenantScopeOnly] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]
 ```
 
@@ -50,6 +50,13 @@ Test-CsEffectiveTenantDialPlan -DialedNumber 14258828080 -Identity adelev@contos
 
 This example tests the given dialed number against a specific identity.
 
+### -------------------------- Example 3 --------------------------
+```
+Get-CsEffectiveTenantDialPlan -Identity adelev | Test-CsEffectiveTenantDialPlan -DialedNumber 14258828080 -CallerNumber 1234567890
+```
+
+This example gets the Identity of a dial plan that is associated with the identity of an user, and applies the retrieved tenant dial plan specific to the phone number which will be used as the caller number to normalize the dialed number.
+
 ## PARAMETERS
 
 ### -Confirm
@@ -88,6 +95,22 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -CallerNumber
+The CallerNumber parameter is the phone number assigned to the user, used to identify which effective tenant dial plan to use.
+
+```yaml
+Type: PhoneNumber
+Parameter Sets: (All)
+Aliases: 
+Applicable: Skype for Business Online
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -EffectiveTenantDialPlanName
 
 > Applicable: Microsoft Teams