Skip to content

Updating end user notification and phone number Filter options #12777

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Jun 2, 2025
Merged

Updating end user notification and phone number Filter options #12777

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
bd75aee
Update Set-CsPhoneNumberAssignment.md
pavellatif May 30, 2025
f721f56
Update Get-CsPhoneNumberAssignment.md
pavellatif May 30, 2025
f733d26
Update Set-CsPhoneNumberAssignment.md
pavellatif May 30, 2025
530dadf
Merge branch 'main' into main
sfrancis206 Jun 2, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 22 additions & 3 deletions teams/teams-ps/teams/Get-CsPhoneNumberAssignment.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down
25 changes: 24 additions & 1 deletion teams/teams-ps/teams/Set-CsPhoneNumberAssignment.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down Expand Up @@ -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

Expand Down Expand Up @@ -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).

Expand Down