From bd75aeeb6820e30297e130d9e0ce8a334af60352 Mon Sep 17 00:00:00 2001 From: pavellatif <142821210+pavellatif@users.noreply.github.com> Date: Thu, 29 May 2025 20:54:50 -0400 Subject: [PATCH 1/3] Update Set-CsPhoneNumberAssignment.md Adding email notify option via cmdlet during phone number assignment --- .../teams/Set-CsPhoneNumberAssignment.md | 25 ++++++++++++++++++- 1 file changed, 24 insertions(+), 1 deletion(-) diff --git a/teams/teams-ps/teams/Set-CsPhoneNumberAssignment.md b/teams/teams-ps/teams/Set-CsPhoneNumberAssignment.md index 618ec4d542..f3f0f174c4 100644 --- a/teams/teams-ps/teams/Set-CsPhoneNumberAssignment.md +++ b/teams/teams-ps/teams/Set-CsPhoneNumberAssignment.md @@ -44,6 +44,11 @@ Set-CsPhoneNumberAssignment -Identity -EnterpriseVoiceEnabled Set-CsPhoneNumberAssignment -PhoneNumber -ReverseNumberLookup [] ``` +### Notify +```powershell +Set-CsPhoneNumberAssignment -Identity -PhoneNumber -PhoneNumberType -Notify [] +``` + ## DESCRIPTION This cmdlet assigns a phone number to a user or resource account. When you assign a phone number the EnterpriseVoiceEnabled flag is automatically set to True. @@ -149,7 +154,11 @@ This example shows how to turn off reverse number lookup (RNL) on a phone number Set-CsPhoneNumberAssignment -Identity user1@contoso.com -PhoneNumber '+14255551234' -PhoneNumberType CallingPlan -AssignmentCategory Private ``` This example shows how to assign a private phone number (incoming calls only) to a user. - +### Example 13 +```powershell +Set-CsPhoneNumberAssignment -Identity user1@contoso.com -PhoneNumber '+14255551234' -PhoneNumberType CallingPlan -LocationId "7fda0c0b-6a3d-48b8-854b-3fbe9dcf6513" -Notify +``` +This example shows how to send an email to Teams phone users informing them about the new telephone number assignment. ## PARAMETERS @@ -280,6 +289,20 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -Notify +Sends an email to Teams phone user about new telephone number assignment. + +```yaml +Type: Switch +Parameter Sets: (Notify) +Aliases: + +Required: False +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### CommonParameters This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). From f721f56740e32f3e062be225822889511f6df429 Mon Sep 17 00:00:00 2001 From: pavellatif <142821210+pavellatif@users.noreply.github.com> Date: Thu, 29 May 2025 21:52:18 -0400 Subject: [PATCH 2/3] Update Get-CsPhoneNumberAssignment.md Adding list of supported filters --- .../teams/Get-CsPhoneNumberAssignment.md | 25 ++++++++++++++++--- 1 file changed, 22 insertions(+), 3 deletions(-) diff --git a/teams/teams-ps/teams/Get-CsPhoneNumberAssignment.md b/teams/teams-ps/teams/Get-CsPhoneNumberAssignment.md index ff8279be6a..9b68146e1f 100644 --- a/teams/teams-ps/teams/Get-CsPhoneNumberAssignment.md +++ b/teams/teams-ps/teams/Get-CsPhoneNumberAssignment.md @@ -28,9 +28,28 @@ Get-CsPhoneNumberAssignment [-ActivationState ] [-AssignedPstnTargetId < ``` ## DESCRIPTION -This cmdlet displays information about one or more phone numbers. You can filter the phone numbers to return by using different parameters. - -Returned results are sorted by TelephoneNumber in ascending order. +This cmdlet displays information about one or more phone numbers. You can filter the phone numbers to return by using different parameters. Returned results are sorted by TelephoneNumber in ascending order. Supported list of attributes for Filter are: +- TelephoneNumber +- OperatorId +- PstnAssignmentStatus (also supported AssignmentStatus) +- ActivationState +- IsoCountryCode +- Capability (also supported AcquiredCapabilities) +- IsOperatorConnect +- PstnPartnerName (also supported PartnerName) +- LocationId +- CivicAddressId +- NetworkSiteId +- NumberType +- AssignedPstnTargetId (also supported TargetId) +- TargetType +- AssignmentCategory +- ResourceAccountSharedCallingPolicySupported +- SupportedCustomerActions +- ReverseNumberLookup +- RoutingOptions +- SmsActivationState +- Tags If you are using both -Skip X and -Top Y for filtering, the returned results will first be skipped by X, and then the top Y results will be returned. From f733d26d070f431a4c17dd1c677b8c6e5a038b96 Mon Sep 17 00:00:00 2001 From: pavellatif <142821210+pavellatif@users.noreply.github.com> Date: Fri, 30 May 2025 12:47:14 -0400 Subject: [PATCH 3/3] Update Set-CsPhoneNumberAssignment.md --- teams/teams-ps/teams/Set-CsPhoneNumberAssignment.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/teams/teams-ps/teams/Set-CsPhoneNumberAssignment.md b/teams/teams-ps/teams/Set-CsPhoneNumberAssignment.md index f3f0f174c4..4ef22599c9 100644 --- a/teams/teams-ps/teams/Set-CsPhoneNumberAssignment.md +++ b/teams/teams-ps/teams/Set-CsPhoneNumberAssignment.md @@ -158,7 +158,7 @@ This example shows how to assign a private phone number (incoming calls only) to ```powershell Set-CsPhoneNumberAssignment -Identity user1@contoso.com -PhoneNumber '+14255551234' -PhoneNumberType CallingPlan -LocationId "7fda0c0b-6a3d-48b8-854b-3fbe9dcf6513" -Notify ``` -This example shows how to send an email to Teams phone users informing them about the new telephone number assignment. +This example shows how to send an email to Teams phone users informing them about the new telephone number assignment. Note: For assignment of India telephone numbers provided by Airtel, Teams Phone users will automatically receive an email outlining the usage guidelines and restrictions. This notification is mandatory and cannot be opted out of. ## PARAMETERS @@ -294,7 +294,7 @@ Sends an email to Teams phone user about new telephone number assignment. ```yaml Type: Switch -Parameter Sets: (Notify) +Parameter Sets: (Assignment) Aliases: Required: False