Skip to content

Latest commit

 

History

History
102 lines (77 loc) · 3.82 KB

Get-MatchingPatternForCallRestriction.md

File metadata and controls

102 lines (77 loc) · 3.82 KB
external help file Module Name online version schema
TeamsFunctions-help.xml
TeamsFunctions
2.0.0

Get-MatchingPatternForCallRestriction

SYNOPSIS

Returns matching patterns for Voice Routes restricted to specific levels

SYNTAX

Get-MatchingPatternForCallRestriction [[-Country] <Object>] [<CommonParameters>]

DESCRIPTION

Returns a custom Object containing matching patterns for different Call Restrictions applied to Voice Routes Builds on the information provided in Get-ISO3166Country and returns custom Object containing matching patterns. The Object contains the Patterns for the following Call Restriction levels

  • Unrestricted is hardcoded to '.*'
  • International is allowing all Calls starting with a + or Emergency Services Numbers
  • National is allowing all Calls starting with a + followed by the Country Dial Code or Emergency Services Numbers
  • The Emergency Services Pattern is currently hardcoded/catch-all. Please see notes for details

EXAMPLES

EXAMPLE 1

Get-MatchingPatternForCallRestriction -Country DE

Returns entry for Country "Germany" queried from the TwoLetterCode (ISO3166-Alpha2) DE

EXAMPLE 2

Get-MatchingPatternForCallRestriction -Country AUT

Returns entry for Country "Austria" queried from the ThreeLetterCode (ISO3166-Alpha3) AUT

PARAMETERS

-Country

ISO 3166-alpha2 - Two Letter Country Code or ISO 3166-alpha3 - Three Letter Country Code. A match must be found through Get-ISO3166Country.

Type: Object
Parameter Sets: (All)
Aliases:

Required: False
Position: 1
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.

INPUTS

System.String

OUTPUTS

System.Object

NOTES

This CmdLet builds on Get-ISO3166Country and expects a match to be found there. From most to least restrictive: EmergencyOnly: Allowing only Calls to these numbers '<EmergencyPattern>' National: All Calls starting with a + followed by the Country Dial Code or Emergency Services Numbers '^+<CountryDialCode>|<EmergencyPattern>' International: Allowing all Calls starting with a + or Emergency Services Numbers '^+|<EmergencyPattern>' Unrestricted: Hardcoded to allow all calls '.*'

The Pattern for Unrestricted is hardcoded to '.*' The Pattern for International is allowing all Calls starting with a + or Emergency Services Numbers The Pattern for National is allowing all Calls starting with a + followed by the Country Dial Code or Emergency Services Numbers The Emergency Services Pattern is currently hardcoded. A catch-all matching pattern covering most countries' Service Numbers ('any 2-5 digit number') is used If a more granular pattern is available, this pattern is added here over time.

This CmdLet was initially geared towards querying the UC DialPlans API to return the Emergency Services pattern This is not yet available as the API requires a key to return usable data.

RELATED LINKS

https://github.com/DEberhardt/TeamsFunctions/tree/main/docs/Get-MatchingPatternForCallRestriction.md

https://github.com/DEberhardt/TeamsFunctions/tree/main/docs/about_Supporting_Functions.md

https://github.com/DEberhardt/TeamsFunctions/tree/main/docs/