Merge pull request #12777 from pavellatif/main

Updating end user notification and phone number Filter options

Author: sfrancis206

teams/teams-ps/teams/Get-CsPhoneNumberAssignment.md

@@ -28,9 +28,28 @@ Get-CsPhoneNumberAssignment [-ActivationState <string>] [-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.
 

teams/teams-ps/teams/Set-CsPhoneNumberAssignment.md

@@ -44,6 +44,11 @@ Set-CsPhoneNumberAssignment -Identity <String> -EnterpriseVoiceEnabled <Boolean>
 Set-CsPhoneNumberAssignment -PhoneNumber <string> -ReverseNumberLookup <string> [<CommonParameters>]
 ```
 
+### Notify
+```powershell
+Set-CsPhoneNumberAssignment -Identity <string> -PhoneNumber <string> -PhoneNumberType <String> -Notify [<CommonParameters>]
+```
+
 ## 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 [email protected] -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 [email protected] -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. 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
 
@@ -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: (Assignment)
+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).