Set-CsTenantBlockedCallingNumbers

Set-CsTenantBlockedCallingNumbers
    [[-Identity] <String>]
    [-Confirm]
    [-Enabled <Object>]
    [-Force]
    [-InboundBlockedNumberPatterns <Object>]
    [-InboundExemptNumberPatterns <Object>]
    [-Instance <Object>]
    [-Name <Object>]
    [-Tenant <Object>]
    [-WhatIf]
    [<CommonParameters>]

Microsoft Direct Routing, Operator Connect and Calling Plans supports blocking of inbound calls from the public switched telephone network (PSTN). This feature allows a tenant-global list of number patterns to be defined so that the caller ID of every incoming PSTN call to the tenant can be checked against the list for a match. If a match is made, an incoming call is rejected.

The tenant blocked calling numbers includes a list of inbound blocked number patterns. Number patterns are managed through the CsInboundBlockedNumberPattern commands New, Get, Set, and Remove. You can manage a given pattern by using these cmdlets, including the ability to toggle the activation of a given pattern.

The tenant blocked calling numbers also includes a list of number patterns exempt from call blocking. Exempt number patterns are managed through the CsInboundExemptNumberPattern commands New, Get, Set, and Remove. You can manage a given pattern by using these cmdlets, including the ability to toggle the activation of a given pattern.

You can test your number blocking by using the Test-CsInboundBlockedNumberPattern command.

The scope of tenant blocked calling numbers is global across the given tenant. This command-let can also turn on/off the blocked calling numbers setting at the tenant level.

To get the current tenant blocked calling numbers setting, use Get-CsTenantBlockedCallingNumbers

Set-CsTenantBlockedCallingNumbers -Enabled $false

This example turns off the tenant blocked calling numbers setting. No inbound number will be blocked from this feature.

Set-CsTenantBlockedCallingNumbers -Enabled $true

This example turns on the tenant blocked calling numbers setting. Inbound calls will be blocked based on the list of blocked number patterns.

Set-CsTenantBlockedCallingNumbers -Name "MyCustomBlockedCallingNumbersName"

This example renames the current blocked calling numbers with "MyCustomBlockedCallingNumbersName". No change is made besides the Name field change.

Set-CsTenantBlockedCallingNumbers -InboundBlockedNumberPatterns @((New-CsInboundBlockedNumberPattern -Name "AnonymousBlockedPattern" -Enabled $true -Pattern "^(?!)Anonymous"))

This example sets the tenant blocked calling numbers with a new list of inbound blocked number patterns. There is a new InboundBlockedNumberPattern being created. The pattern name is "AnonymousBlockedPattern". The pattern is turned on. The pattern is a normalization rule which contains "Anonymous".

Note that if the current InboundBlockedNumberPatterns already contains a list of patterns while a new pattern needs to be created, this example will wipe out the existing patterns and only add the new one. Please save the current InboundBlockedNumberPatterns list before adding new patterns.

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.