Partager via

  • Article

Get-CsUnassignedNumber

 

Dernière rubrique modifiée : 2012-03-23

Extrait une ou plusieurs plages de numéros non affectés et les règles de routage qui s’appliquent à ces numéros.

Syntaxe

Get-CsUnassignedNumber [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]

Get-CsUnassignedNumber [-Filter <String>] [-LocalStore <SwitchParameter>]

Description détaillée

Les numéros non affectés sont des numéros de téléphone qui ont été affectés à une organisation, mais pas à des utilisateurs ou des téléphones spécifiques. Vous pouvez configurer Microsoft Lync Server 2010 pour acheminer des appels vers les destinations désirées lors de l’appel d’un numéro non affecté. Cette cmdlet extrait une ou plusieurs plages de numéros non affectés définissant ce routage.

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Get-CsUnassignedNumber : RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmin. Pour retourner une liste de tous les rôles RBAC (Contrôle d’accès basé sur un rôle) auxquels cette cmdlet a été affectée (y compris les rôles RBAC personnalisés créés par vos soins), exécutez la commande suivante à l’invite Windows PowerShell :

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsUnassignedNumber"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsGlobalRelativeIdentity

Nom unique de la plage de numéros non affectés à extraire.

Filter

Facultatif

Chaîne

Effectue une recherche par caractères génériques qui vous permet de limiter les résultats aux paramètres de numéros non affectés dont les identités correspondent à la chaîne de caractères génériques donnée.

LocalStore

Facultatif

Paramètre de commutateur

Extrait les données des numéros non affectés à partir du réplica local du magasin central de gestion, et non du magasin central de gestion lui-même.

Types d’entrées

Aucun.

Types de retours

Retourne un objet de type Microsoft.Rtc.Management.Voice.Helpers.DisplayAnnouncementVacantNumberRange.

Exemple

-------------------------- Exemple 1 --------------------------

Get-CsUnassignedNumber

L’exemple 1 retourne un ensemble de tous les numéros non affectés configurés en vue de leur utilisation dans votre organisation.

-------------------------- Exemple 2 --------------------------

Get-CsUnassignedNumber -Identity UNSet1

Dans l’exemple 2, le paramètre Identity est utilisé pour limiter les données extraites aux numéros non affectés dont l'identité est UNSet1. Étant donné que les identités doivent être uniques, cette commande retourne uniquement la plage de numéros non affectés.

-------------------------- Exemple 3 --------------------------

Get-CsUnassignedNumber -Filter *Redmond*

Cet exemple utilise le paramètre Filter pour retourner un ensemble de tous les paramètres de numéros non affectés dont les valeurs d’identité comprennent la chaîne Redmond. Par exemple, cette commande retourne les paramètres de numéros non affectés avec les identités Redmond Numbers, Unassigned Redmond Numbers, UNRedmond, etc.

-------------------------- Exemple 4 --------------------------

Get-CsUnassignedNumber | Where-Object {$_.AnnouncementName -match "Welcome"}

Dans l’exemple 4, les cmdlets Get-CsUnassignedNumber et Where-Object sont utilisées pour extraire la collection de tous les paramètres de numéros non affectés qui comprennent le mot Welcome (Bienvenue) dans le nom de l’annonce (« Announcement » dans l’exemple). Pour cela, la commande utilise d’abord Get-CsUnassignedNumber pour extraire tous les paramètres de numéros non affectés. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui applique un filtre limitant les données retournées aux numéros non affectés qui comprennent le mot Welcome dans le nom de l’annonce.