Update Get-CsPhoneNumberAssignment.md

Updating examples and adding a new Filter parameter

Author: pavellatif

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

@@ -20,7 +20,7 @@ This cmdlet displays information about one or more phone numbers.
 ### Assignment (Default)
 ```powershell
 Get-CsPhoneNumberAssignment [-ActivationState <string>] [-AssignedPstnTargetId <string>] [-AssignmentCategory <string>]
- [-CapabilitiesContain <string>] [-CivicAddressId <string>] [-IsoCountryCode <string>]
+ [-CapabilitiesContain <string>] [-CivicAddressId <string>] [-Filter <String>] [-IsoCountryCode <string>]
  [-LocationId <string>] [-NetworkSiteId <string>] [-NumberType <string>] [-PstnAssignmentStatus <string>] [-Skip <int>] [-TelephoneNumber <string>]
  [-TelephoneNumberContain <string>] [-TelephoneNumberGreaterThan <string>] [-TelephoneNumberLessThan <string>]
  [-TelephoneNumberStartsWith <string>] [-Top <int>] [<CommonParameters>]
@@ -33,7 +33,7 @@ Returned results are sorted by TelephoneNumber in ascending order.
 
 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.
 
-By default, this cmdlet returns a maximum of 500 results.
+By default, this cmdlet returns a maximum of 500 results. A maximum of 1000 results can be returned using -Top filter. If you need to get more than 1000 results, a combination of -Skip and -Top filtering can be used list an incremental page of 1000 numbers. If a full list of telephone numbers acquired by the tenant is required, you can use [Export-CsAcquiredPhoneNumber](https://learn.microsoft.com/powershell/module/teams/export-csacquiredphonenumber) cmdlet to download a list of all acquired telephone numbers.
 
 ## EXAMPLES
 
@@ -139,15 +139,21 @@ This example returns the number of Calling Plan or Operator Connect service phon
 ```powershell
 Get-CsPhoneNumberAssignment -Top ([int]::MaxValue)
 ```
-This example returns all phone numbers.
+This example returns all phone numbers upto a maximum 1000 results.
 
 ### Example 11
 ```powershell
+Get-CsPhoneNumberAssignment -Skip 1000 -Top 1000
+```
+This example returns all phone numbers between 1001 to 2000 sequence.
+
+### Example 12
+```powershell
 Get-CsPhoneNumberAssignment -AssignedPstnTargetId 'TeamsSharedCallingRoutingPolicy|Tag:SC1'
 ```
 This example returns all phone numbers assigned as emergency numbers in the Teams shared calling routing policy instance SC1.
 
-### Example 12
+### Example 13
 ```powershell
 Get-CsPhoneNumberAssignment -TelephoneNumber "+12065551000;ext=524"
 ```
@@ -175,6 +181,63 @@ ReverseNumberLookup		: {SkipInternalVoip}
 ```
 This example displays when SkipInternalVoip option is turned on for a number.
 
+### Example 14
+```powershell
+Get-CsPhoneNumberAssignment -Filter "TelephoneNumber -eq '+12065551000"
+```
+```output
+TelephoneNumber         : +12065551000
+OperatorId              : 83d289bc-a4d3-41e6-8a3f-cff260a3f091
+NumberType              : DirectRouting
+ActivationState         : Activated
+AssignedPstnTargetId    : 2713551e-ed63-415d-9175-fc4ff825a0be
+AssignmentCategory      : Primary
+Capability              : {ConferenceAssignment, VoiceApplicationAssignment, UserAssignment}
+City                    :
+CivicAddressId          : 00000000-0000-0000-0000-000000000000
+IsoCountryCode          :
+IsoSubdivision          :
+LocationId              : 00000000-0000-0000-0000-000000000000
+LocationUpdateSupported : True
+NetworkSiteId           :
+PortInOrderStatus       :
+PstnAssignmentStatus    : UserAssigned
+PstnPartnerId           :
+PstnPartnerName         :
+NumberSource            : OnPremises
+ReverseNumberLookup		: {}
+```
+This example shows a way to use -Filter parameter to display information of a specific number.
+
+### Example 15
+```powershell
+Get-CsPhoneNumberAssignment -Filter "TelephoneNumber -like '+12065551000' -and NumberType -eq 'DirectRouting'"
+```
+```output
+TelephoneNumber         : +12065551000
+OperatorId              : 83d289bc-a4d3-41e6-8a3f-cff260a3f091
+NumberType              : DirectRouting
+ActivationState         : Activated
+AssignedPstnTargetId    : 2713551e-ed63-415d-9175-fc4ff825a0be
+AssignmentCategory      : Primary
+Capability              : {ConferenceAssignment, VoiceApplicationAssignment, UserAssignment}
+City                    :
+CivicAddressId          : 00000000-0000-0000-0000-000000000000
+IsoCountryCode          :
+IsoSubdivision          :
+LocationId              : 00000000-0000-0000-0000-000000000000
+LocationUpdateSupported : True
+NetworkSiteId           :
+PortInOrderStatus       :
+PstnAssignmentStatus    : UserAssigned
+PstnPartnerId           :
+PstnPartnerName         :
+NumberSource            : OnPremises
+ReverseNumberLookup		: {}
+```
+This example shows a way to get filtered results using multiple Filter parameters.
+
+
 ## PARAMETERS
 
 ### -ActivationState
@@ -256,6 +319,21 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -Filter
+{{ Fill Filter Description }}
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -IsoCountryCode
 Filters the returned results based on the ISO 3166-1 Alpha-2 country code assigned to the phone number.