Updating syntax and examples for email notifcation during telephone number assignment and unassignment

Author: pavellatif

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

@@ -473,7 +473,7 @@ Accept wildcard characters: False
 
 > Applicable: Microsoft Teams
 
-This parameter is reserved for internal Microsoft use.
+ID of a network site. A network site represents a location where your organization has a physical venue, such as offices, a set of buildings, or a campus.
 
 ```yaml
 Type: System.String

teams/teams-ps/MicrosoftTeams/Remove-CsPhoneNumberAssignment.md

@@ -20,13 +20,13 @@ This cmdlet will remove/unassign a phone number from a user or a resource accoun
 ### RemoveSome (Default)
 ```
 Remove-CsPhoneNumberAssignment -Identity <String> -PhoneNumber <String> -PhoneNumberType <String>
- [-HttpPipelinePrepend <SendAsyncStep[]>] [<CommonParameters>]
+ [-HttpPipelinePrepend <SendAsyncStep[]>] [-Notify] [<CommonParameters>]
 ```
 
 ### RemoveAll
 ```
 Remove-CsPhoneNumberAssignment -Identity <String> [-HttpPipelinePrepend <SendAsyncStep[]>] [-RemoveAll]
- [<CommonParameters>]
+ [-Notify] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
@@ -58,13 +58,13 @@ This example removes/unassigns all the telephone number from user2@contoso.com.
 
 ### Example 3
 ```powershell
-Remove-CsPhoneNumberAssignment -Identity user1@contoso.com -PhoneNumber +12065551234 -PhoneNumberType CallingPlan
+Remove-CsPhoneNumberAssignment -Identity user1@contoso.com -PhoneNumber +12065551234 -PhoneNumberType CallingPlan -Notify
 ```
 This example removes/unassigns the Microsoft Calling Plan phone number +1 (206) 555-1234 from the user user1@contoso.com and also sends an email notification to the user about the removal of telephone number.
 
 ### Example 4
 ```powershell
-Remove-CsPhoneNumberAssignment -Identity user2@contoso.com -RemoveAll
+Remove-CsPhoneNumberAssignment -Identity user2@contoso.com -RemoveAll -Notify
 ```
 This example removes/unassigns all the telephone number from user2@contoso.com and also sends an email notification to the user about the change.
 
@@ -146,6 +146,20 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -Notify
+Sends a best-effort email notification when a phone number is removed. Failures to send email are not reported.
+
+```yaml
+Type: Switch
+Parameter Sets: (RemoveSome, RemoveAll)
+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](http://go.microsoft.com/fwlink/?LinkID=113216).
 

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

@@ -39,7 +39,7 @@ Set-CsPhoneNumberAssignment -PhoneNumber <String> [-HttpPipelinePrepend <SendAsy
 ```
 Set-CsPhoneNumberAssignment -PhoneNumber <String> [-LocationId <String>]
  [-HttpPipelinePrepend <SendAsyncStep[]>] -Identity <String> -PhoneNumberType <String>
- [-NetworkSiteId <String>] [-AssignmentCategory <String>] [-ReverseNumberLookup <String>] [<CommonParameters>]
+ [-NetworkSiteId <String>] [-AssignmentCategory <String>] [-ReverseNumberLookup <String>] [-Notify] [<CommonParameters>]
 ```
 
 ### Attribute
@@ -48,8 +48,13 @@ Set-CsPhoneNumberAssignment [-HttpPipelinePrepend <SendAsyncStep[]>] -Identity <
  -EnterpriseVoiceEnabled <Boolean> [<CommonParameters>]
 ```
 
+### Notify
+```
+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.
+This cmdlet assigns a telephone number to a user or resource account. When you assign a phone number the EnterpriseVoiceEnabled flag is automatically set to True.
 
 You can also assign a location to a phone number.
 
@@ -284,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
+```
+
 ### -PhoneNumber
 The phone number to assign to the user or resource account. Supports E.164 format like +12065551234 and non-E.164 format like 12065551234. The phone number can't have "tel:" prefixed.