Bloquer les appels entrantsBlock inbound calls

Le système téléphonique et les offres d’appels prennent en charge le blocage des appels entrants du réseau téléphonique public commuté (RTC).Phone System Direct Routing and Calling Plans support blocking inbound calls from the Public Switched Telephone Network (PSTN). Cette fonctionnalité permet de définir une liste globale de clients de modèles de nombre de manière à ce que l’ID d’appelant de chaque appel RTC entrant au client puisse être vérifié par rapport à la liste de correspondance.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 une correspondance est établie, un appel entrant est rejeté.If a match is made, an incoming call is rejected.

Cette fonctionnalité de blocage des appels entrants ne fonctionne que sur les appels entrants provenant du RTC et ne fonctionne que sur une base globale du client.This inbound call blocking feature only works on inbound calls that originate from the PSTN and only works on a tenant-global basis. Cette fonction n’est pas disponible par utilisateur.It's not available on a per-user basis.

Notes

Les appelants bloqués peuvent avoir un comportement légèrement différent lorsqu’ils sont bloqués.Blocked callers may experience slightly different behaviors when they've been blocked. Ce comportement dépend de la façon dont le transporteur de l’appelant bloqué gère la notification d’échec de l’appel.The behavior is based on how the blocked caller’s carrier handles the notification that the call isn't allowed to be successfully completed. Par exemple, vous pouvez inclure un message de transporteur indiquant que l’appel ne peut pas être effectué comme composé, ou simplement en déposant un appel.Examples may include a carrier message stating the call can't be completed as dialed, or simply dropping the call.

Appels et contrôles d’administration de blocageCall blocking admin controls and information

Les contrôles d’administration pour bloquer les numéros sont fournis uniquement via PowerShell.Admin controls for blocking numbers are provided using PowerShell only. Les modèles de blocs de nombres sont définis en tant que modèles d’expressions normales.Number block patterns are defined as regular expression patterns. L’ordre des expressions n’est pas important : le premier modèle correspondant dans la liste entraîne le blocage de l’appel.The order of the expressions is unimportant – the first pattern matched in the list results in the call being blocked. Un nouveau numéro ou modèle ajouté ou supprimé dans la liste des appelants bloqués peut prendre jusqu’à 24 heures avant que le modèle soit actif.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.

Commandes PowerShell de blocage des appelsCall blocking PowerShell commands

Vous pouvez gérer les modèles de nombre à l’aide des nouvellescmdlets Get, Setet Remove - CsInboundBlockedNumberPattern .You manage number patterns by using the New, Get, Set, Remove -CsInboundBlockedNumberPattern cmdlets. Vous pouvez gérer un modèle donné à l’aide de ces applets de option, y compris la possibilité de basculer entre les activations d’un modèle donné.You can manage a given pattern by using these cmdlets, including the ability to toggle the activation of a given pattern.

L’affichage et l’activation de la fonctionnalité de blocage des appels complet est géré via les applets de CsTenantBlockingCallingNumbers Getet Set - CsTenantBlockingCallingNumbers .Viewing and activating the entire call blocking feature is managed through the Get, Set -CsTenantBlockingCallingNumbers cmdlets.

  • Get-CsTenantBlockedCallingNumbers renvoie les paramètres de la liste globale des numéros bloqués, y compris activé (vrai/faux).Get-CsTenantBlockedCallingNumbers returns the parameters for the global blocked number list including Enabled (True/False). Il existe une seule stratégie de client globale qui ne peut pas être modifiée manuellement en dehors de l’activation ou de la désactivation de la fonctionnalité.There's a single global tenant policy that can't be modified manually other than to turn the feature on or off.
  • Set-CsTenantBlockedCallingNumbers autorise la modification de l’activation et de la désactivation des appels du client global au niveau du client.Set-CsTenantBlockedCallingNumbers allows modifying the global tenant blocked calls to be turned on and off at the tenant level.

ExemplesExamples

Bloquer un numéroBlock a number

Dans cet exemple, les paramètres Enabled et Description sont facultatifs.In this example, the Enabled and Description parameters are optional.

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

La création d’un nouveau modèle ajoute le modèle tel qu’il est activé par défaut.Creating a new pattern adds the pattern as enabled by default. La description est un champ facultatif pour fournir des informations supplémentaires.The description is an optional field to provide more information.

Nous vous recommandons de fournir un nom significatif pour comprendre facilement la raison pour laquelle le modèle a été ajouté.We recommend that you provide a meaningful name to easily understand why the pattern was added. Dans le cas d’un simple blocage des numéros de courrier indésirable, attribuez-lui le même nom que le modèle de nombre que vous avez mis en correspondance et ajoutez des informations supplémentaires dans la description, le cas échéant.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.

Les modèles sont associés à l’aide d’expressions régulières (Regex).Patterns are matched using Regular Expressions (Regex). Autorisez le temps de réplication avant de tester et de valider.Allow time for replication before you test and validate.

Autoriser un numéroAllow a number

Dans cet exemple, le paramètre Identity est obligatoire.In this example, the Identity parameter is required.

Remove-CsInboundBlockedNumberPattern -Identity “<identity>”

Si l’identité n’est pas connue, utilisez l’applet de passe Get-CsInboundBlockedNumberPattern pour trouver le modèle approprié et noter l’identité.If the identity isn't known, use the Get-CsInboundBlockedNumberPattern cmdlet to first locate the proper pattern and note the identity. Ensuite, exécutez l’applet de CsTenantBlockedNumberPattern de suppression et transmettez la valeur d’identité appropriée.Then, run the Remove-CsTenantBlockedNumberPattern cmdlet and pass the appropriate identity value.

Autorisez le temps de réplication avant de tester et de valider.Allow time for replication before you test and validate.

Afficher tous les modèles de nombreView all number patterns

L’exécution de cette cmdlet renvoie la liste de tous les numéros bloqués entrés pour un client :Running this cmdlet returns a list of all blocked numbers that are entered for a tenant:

Get-CsInboundBlockedNumberPattern

Utilisez des capacités de filtrage PowerShell intégrées pour analyser les valeurs renvoyées selon les besoins.Use built-in PowerShell filtering abilities to parse the returned values as required.

Ajouter des exceptions de nombreAdd number exceptions

Vous pouvez ajouter des exceptions aux modèles de nombre bloqués à l’aide des applets de nouvelleapplet de CsTenantBlockNumberExceptionPattern, Get, Setet Remove - CsTenantBlockNumberExceptionPattern .You can add exceptions to blocked number patterns by using the New, Get, Set, Remove -CsTenantBlockNumberExceptionPattern cmdlets.

ExemplesExamples

Ajouter une exception de nombreAdd a number exception

Dans cet exemple, un nouveau modèle d’exception de nombre est créé et il ajoute par défaut le modèle est activé.In this example, a new number exception pattern is created and will by default add the pattern as enabled. Les paramètres Enabled et Description sont facultatifs.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"  

Afficher toutes les exceptions d’une numérotationView all number exceptions

Dans cet exemple, le paramètre Identity est facultatif.In this example, the Identity parameter is optional. Si le paramètre Identity n’est pas spécifié, cette applet de cmdlet renvoie une liste de modèles d’exception de nombre entrés pour un client.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

Modifier une exception de nombreModify a number exception

Dans cet exemple, le paramètre Identity est obligatoire.In this example, the Identity parameter is mandatory. L’applet de passe Set-CsTenantBlockedNumberExceptionPattern vous permet de modifier un ou plusieurs paramètres pour une identité de modèle de nombre donnée.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*)$" 

Supprimer un numéro d’exceptionRemove a number exception

Dans cet exemple, le paramètre Identity est obligatoire.In this example, the Identity parameter is required. Cette applet de passe supprime le modèle de nombre indiqué de la liste des clients.This cmdlet will remove the given number pattern from the tenant list. Si l’identité n’est pas connue, utilisez l’applet de passe Get-CsInboundBlockedNumberPattern pour trouver le modèle approprié et noter l’identité.If the identity isn't known, use the Get-CsInboundBlockedNumberPattern cmdlet to first locate the proper pattern and note the identity. Ensuite, exécutez l’applet de CsTenantBlockedNumberExceptionPattern de suppression et transmettez la valeur d’identité appropriée.Then, run the Remove-CsTenantBlockedNumberExceptionPattern cmdlet and pass the appropriate identity value.Autorisez le temps de réplication avant de tester et de valider. 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

Tester la présence d’un numéro bloquéTest whether a number is blocked

Utilisez l’applet de contrôle test-CsInboundBlockedNumberPattern pour vérifier si un numéro est bloqué dans le client.Use the Test-CsInboundBlockedNumberPattern cmdlet to verify whether a number is blocked in the tenant.

Dans cet exemple, les paramètres PhoneNumber et locataire sont obligatoires.In this example, the PhoneNumber and Tenant parameters are required. Le paramètre PhoneNumber doit être une chaîne numérique sans caractère supplémentaire, comme + ou-.The PhoneNumber parameter should be a numeric string without any additional characters such as + or -. Dans TRPS, le paramètre locataire est facultatif.In TRPS, the Tenant parameter is optional. Le paramètre isNumberBlocked obtenu renvoie la valeur true si le nombre est bloqué dans le locataire et false dans le cas contraire.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 VraiTrue
Test-CsInboundBlockedNumberPattern -Tenant e09ad6bc-1d3c-4650-8cae-02f6c5a04b45 -PhoneNumber 6045550188
httpResponseCodehttpResponseCode isNumberBlockedisNumberBlocked errorMessageerrorMessage
200200 FalseFalse

Note concernant RegexA note about Regex

Comme indiqué plus haut, le modèle correspondant au blocage des appelants est réalisé à l’aide de Regex.As stated earlier, the pattern matching for blocking callers is done by using Regex. Plusieurs outils sont disponibles en ligne pour vous aider à valider une correspondance de modèle Regex.Multiple tools are available online to help validate a Regex pattern match. Si vous n’êtes pas familiarisé avec les modèles Regex, nous vous conseillons de prendre le temps de vous familiariser avec les concepts de base.If you aren't familiar with Regex patterns, we recommend that you take some time to familiarize yourself with the basics. Pour vous assurer que vous obtenez les résultats attendus, utilisez un outil permettant de valider les correspondances de modèles avant d’ajouter le nouveau numéro bloqué à votre client.To make sure you get expected results, use a tool for validating pattern matches before you add new blocked number matches to your tenant.