Bloquear llamadas entrantesBlock inbound calls

Los planes de llamadas y enrutamiento directo del sistema telefónico admiten el bloqueo de llamadas entrantes desde la red de telefonía pública conmutada (RTC).Phone System Direct Routing and Calling Plans support blocking inbound calls from the Public Switched Telephone Network (PSTN). Esta característica permite que se defina una lista global de inquilinos de patrones de números para que la identificación de llamadas de todas las llamadas RTC entrantes en el inquilino se pueda comprobar con la lista en busca de una coincidencia.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. Si se realiza una coincidencia, se rechaza una llamada entrante.If a match is made, an incoming call is rejected.

Esta característica de bloqueo de llamadas entrantes solo funciona en llamadas entrantes que se originan desde la RTC y solo funciona con un inquilino global.This inbound call blocking feature only works on inbound calls that originate from the PSTN and only works on a tenant-global basis. No está disponible para cada usuario.It's not available on a per-user basis.

Nota

Los autores de llamadas bloqueados pueden experimentar comportamientos ligeramente diferentes cuando se han bloqueado.Blocked callers may experience slightly different behaviors when they've been blocked. El comportamiento se basa en la forma en que el portador de la persona que llama bloqueada controla la notificación de que la llamada no se puede completar correctamente.The behavior is based on how the blocked caller’s carrier handles the notification that the call isn't allowed to be successfully completed. Es posible que algunos ejemplos incluyan un mensaje que indica que la llamada no se puede completar como marcando o simplemente se encuentra en la llamada.Examples may include a carrier message stating the call can't be completed as dialed, or simply dropping the call.

Información y controles de administración con bloqueo de llamadasCall blocking admin controls and information

Los controles de administración para números de bloqueo se proporcionan con PowerShell solo.Admin controls for blocking numbers are provided using PowerShell only. Los patrones de bloques de números se definen como patrones de expresiones regulares.Number block patterns are defined as regular expression patterns. El orden de las expresiones no es importante, el primer patrón que coincide en la lista provoca la bloqueo de la llamada.The order of the expressions is unimportant – the first pattern matched in the list results in the call being blocked. Un nuevo número o patrón que se agrega o se elimina en la lista de llamadas bloqueadas puede demorar hasta 24 horas para que el patrón se active.A new number or pattern that's added or removed in the blocked callers list may take up to 24 hours for the pattern to become active.

Comandos de PowerShell de bloqueo de llamadasCall blocking PowerShell commands

Para administrar los patrones de números, use los cmdlets New, Get, set, Remove - CsInboundBlockedNumberPattern .You manage number patterns by using the New, Get, Set, Remove -CsInboundBlockedNumberPattern cmdlets. Puede administrar un patrón determinado con estos cmdlets, incluida la capacidad de activar o desactivar la activación de un patrón determinado.You can manage a given pattern by using these cmdlets, including the ability to toggle the activation of a given pattern.

La visualización y activación de toda la característica de bloqueo de llamadas se administra a través de los cmdlets Get, set - CsTenantBlockingCallingNumbers .Viewing and activating the entire call blocking feature is managed through the Get, Set -CsTenantBlockingCallingNumbers cmdlets.

  • Get-CsTenantBlockedCallingNumbers devuelve los parámetros de la lista global de números bloqueados, que incluye Enabled (verdadero/falso).Get-CsTenantBlockedCallingNumbers returns the parameters for the global blocked number list including Enabled (True/False). Hay una única directiva de inquilino global que no se puede modificar de forma manual salvo para activar o desactivar la característica.There's a single global tenant policy that can't be modified manually other than to turn the feature on or off.
  • Set-CsTenantBlockedCallingNumbers permite modificar las llamadas de inquilino global bloqueadas y desactivadas en el nivel de inquilino.Set-CsTenantBlockedCallingNumbers allows modifying the global tenant blocked calls to be turned on and off at the tenant level.

EjemplosExamples

Bloquear un númeroBlock a number

En este ejemplo, los parámetros Enabled y Description son opcionales.In this example, the Enabled and Description parameters are optional.

New-CsInboundBlockedNumberPattern -Name “<name>” -Enabled $True -Description “<description>” -Pattern “^[+]?13125550000”

La creación de un nuevo patrón agrega el patrón como habilitado de forma predeterminada.Creating a new pattern adds the pattern as enabled by default. La descripción es un campo opcional para proporcionar más información.The description is an optional field to provide more information.

Le recomendamos que proporcione un nombre significativo para comprender fácilmente por qué se agregó el patrón.We recommend that you provide a meaningful name to easily understand why the pattern was added. En el caso de simplemente bloquear los números de correo no deseado, considere la posibilidad de nombrar la regla como el patrón de número que se está cotejando y agregue información adicional en la descripción según sea necesario.In the case of simply blocking spam numbers, consider naming the rule the same as the number pattern that's being matched and add additional information in the description as required.

Los patrones coinciden con expresiones regulares (regex).Patterns are matched using Regular Expressions (Regex). Deje tiempo para la replicación antes de probar y validar.Allow time for replication before you test and validate.

Permitir un númeroAllow a number

En este ejemplo, se requiere el parámetro Identity .In this example, the Identity parameter is required.

Remove-CsInboundBlockedNumberPattern -Identity “<identity>”

Si no se conoce la identidad, use el cmdlet Get-CsInboundBlockedNumberPattern para ubicar primero el patrón adecuado y anote la identidad.If the identity isn't known, use the Get-CsInboundBlockedNumberPattern cmdlet to first locate the proper pattern and note the identity. A continuación, ejecute el cmdlet Remove-CsTenantBlockedNumberPattern y pase el valor de identidad adecuado.Then, run the Remove-CsTenantBlockedNumberPattern cmdlet and pass the appropriate identity value.

Deje tiempo para la replicación antes de probar y validar.Allow time for replication before you test and validate.

Ver todos los patrones de númerosView all number patterns

La ejecución de este cmdlet devuelve una lista de todos los números bloqueados que se especifican para un inquilino:Running this cmdlet returns a list of all blocked numbers that are entered for a tenant:

Get-CsInboundBlockedNumberPattern

Use las capacidades de filtrado de PowerShell integradas para analizar los valores devueltos según sea necesario.Use built-in PowerShell filtering abilities to parse the returned values as required.

Agregar excepciones de númeroAdd number exceptions

Puede Agregar excepciones a patrones de números bloqueados con los cmdlets New, Get, set, Remove - CsTenantBlockNumberExceptionPattern .You can add exceptions to blocked number patterns by using the New, Get, Set, Remove -CsTenantBlockNumberExceptionPattern cmdlets.

EjemplosExamples

Agregar una excepción de númeroAdd a number exception

En este ejemplo, se crea un patrón de excepción de número nuevo y, de forma predeterminada, agregará el patrón como habilitado.In this example, a new number exception pattern is created and will by default add the pattern as enabled. Los parámetros Enabled y Description son opcionales.The Enabled and Description parameters are optional.

New-CsTenantBlockedNumberExceptionPattern -Identity <XdsGlobalRelativeIdentity> -Tenant <GUID> -Pattern <String> -Enabled <bool> -Description <string>
New-CsTenantBlockedNumberExceptionPattern -Identity InternationalPrefix -Tenant daacb588-18ef-4f77-8c83-955af9615930 -Pattern "^011(\d*)$" -Description "Allow international prefix in US"  

Ver todas las excepciones de númerosView all number exceptions

En este ejemplo, el parámetro Identity es opcional.In this example, the Identity parameter is optional. Si no se especifica el parámetro Identity , este cmdlet devuelve una lista de todos los patrones de excepción de número especificados para un inquilino.If the Identity parameter isn't specified, this cmdlet returns a list of all number exception patterns entered for a tenant.

Get-CsTenantBlockedNumberExceptionPattern -Identity <XdsGlobalRelativeIdentity> -Tenant <GUID>
Get-CsTenantBlockedNumberExceptionPattern -Tenant daacb588-18ef-4f77-8c83-955af9615930

Modificar una excepción de númeroModify a number exception

En este ejemplo, el parámetro Identity es obligatorio.In this example, the Identity parameter is mandatory. El cmdlet set-CsTenantBlockedNumberExceptionPattern le permite modificar uno o más parámetros para una identidad de patrón de número determinada.The Set-CsTenantBlockedNumberExceptionPattern cmdlet lets you modify one or more parameters for a given number pattern identity.

Set-CsTenantBlockedNumberExceptionPattern -Identity <XdsGlobalRelativeIdentity> -Tenant <GUID> -Enabled <bool> -Description <string> -Pattern <string> 
Set-CsTenantBlockedNumberExceptionPattern -Identity InternationalPrefix -Tenant daacb588-18ef-4f77-8c83-955af9615930  -Pattern "^022(\d*)$" 

Quitar una excepción de númeroRemove a number exception

En este ejemplo, se requiere el parámetro Identity .In this example, the Identity parameter is required. Este cmdlet quitará el patrón de número dado de la lista de inquilinos.This cmdlet will remove the given number pattern from the tenant list. Si no se conoce la identidad, use el cmdlet Get-CsInboundBlockedNumberPattern para ubicar primero el patrón adecuado y anote la identidad.If the identity isn't known, use the Get-CsInboundBlockedNumberPattern cmdlet to first locate the proper pattern and note the identity. A continuación, ejecute el cmdlet Remove-CsTenantBlockedNumberExceptionPattern y pase el valor de identidad adecuado.Then, run the Remove-CsTenantBlockedNumberExceptionPattern cmdlet and pass the appropriate identity value.Deje tiempo para la replicación antes de probar y validar. Allow time for replication before you test and validate.

Remove-CsTenantBlockedNumberExceptionPattern -Identity <XdsGlobalRelativeIdentity> -Tenant <GUID>
Remove-CsTenantBlockedNumberExceptionPattern -Identity InternationalPrefix -Tenant daacb588-18ef-4f77-8c83-955af9615930

Comprobar si un número está bloqueadoTest whether a number is blocked

Use el cmdlet Test-CsInboundBlockedNumberPattern para comprobar si un número está bloqueado en el inquilino.Use the Test-CsInboundBlockedNumberPattern cmdlet to verify whether a number is blocked in the tenant.

En este ejemplo, los parámetros PhoneNumber y tenant son obligatorios.In this example, the PhoneNumber and Tenant parameters are required. El parámetro PhoneNumber debe ser una cadena numérica sin caracteres adicionales, como + o-.The PhoneNumber parameter should be a numeric string without any additional characters such as + or -. En TRPS, el parámetro tenant es opcional.In TRPS, the Tenant parameter is optional. El parámetro isNumberBlocked resultante devuelve el valor true si el número está bloqueado en el inquilino y false si no está bloqueado.The resulting isNumberBlocked parameter returns a value of True if the number is blocked in the tenant and False if it's not blocked.

Test-CsInboundBlockedNumberPattern –Tenant <GUID> -PhoneNumber <String>
Test-CsInboundBlockedNumberPattern -Tenant e09ad6bc-1d3c-4650-8cae-02f6c5a04b45 -PhoneNumber 4255550101
httpResponseCodehttpResponseCode isNumberBlockedisNumberBlocked errorMessageerrorMessage
200200 VerdaderoTrue
Test-CsInboundBlockedNumberPattern -Tenant e09ad6bc-1d3c-4650-8cae-02f6c5a04b45 -PhoneNumber 6045550188
httpResponseCodehttpResponseCode isNumberBlockedisNumberBlocked errorMessageerrorMessage
200200 FalsoFalse

Una nota sobre RegexA note about Regex

Como se indicó anteriormente, la coincidencia de patrones para las personas que llaman se realiza usando Regex.As stated earlier, the pattern matching for blocking callers is done by using Regex. Hay varias herramientas disponibles en línea para ayudar a validar una coincidencia de patrón de Regex.Multiple tools are available online to help validate a Regex pattern match. Si no está familiarizado con los patrones de Regex, le recomendamos que tome algún tiempo para familiarizarse con los conceptos básicos.If you aren't familiar with Regex patterns, we recommend that you take some time to familiarize yourself with the basics. Para asegurarse de que obtiene los resultados esperados, use una herramienta para validar las coincidencias de modelos antes de agregar nuevas coincidencias de número bloqueado a su espacio empresarial.To make sure you get expected results, use a tool for validating pattern matches before you add new blocked number matches to your tenant.