Partager via


Get-CsDialInConferencingAccessNumber

 

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

Retourne des informations sur tous les numéros d’accès de conférence rendez-vous configurés en vue d’une utilisation dans votre organisation. Les conférences rendez-vous permettent aux utilisateurs d’utiliser un téléphone fixe ou mobile, ou tout périphérique sur le réseau téléphonique commuté (PSTN), pour rejoindre la partie audio d’une conférence en ligne.

Syntaxe

Get-CsDialInConferencingAccessNumber [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>]

Get-CsDialInConferencingAccessNumber [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OU <OUIdParameter>] [-Region <String>] [-ResultSize <Unlimited>]

Get-CsDialInConferencingAccessNumber -EmptyRegion <SwitchParameter> [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>]

Description détaillée

Les conférences rendez-vous permettent aux utilisateurs d’utiliser tout type de téléphone (téléphone fixe standard, mobile ou VoIP) pour rejoindre la partie audio d’une conférence en ligne. Ceci permet aux utilisateurs de participer à une réunion même s’ils ne disposent ni d’un ordinateur, ni d’une connexion Internet. Les utilisateurs bénéficient de fonctionnalités audio complètes : ils peuvent parler aux autres participants et entendre tout ce qui se passe. En revanche, ils ne pourront pas voir les diapositives, les flux vidéo ou tous les autres éléments visuels partagés.

Pour permettre aux utilisateurs d’utiliser les fonctionnalités de conférence rendez-vous, vous devez créer des numéros d’accès de conférence rendez-vous : il s’agit de numéros de téléphone que les utilisateurs peuvent appeler pour rejoindre une réunion. Les numéros d’accès de conférence rendez-vous sont créés à l’aide de la cmdlet New-CsDialInConferencingAccessNumber. Lorsque vous créez un numéro d’accès de conférence rendez-vous, vous créez en fait un nouvel objet de contact dans services de domaine Active Directory (AD DS), utilisé pour désigner le numéro d’accès et toutes ses propriétés. Les numéros de contact peuvent être récupérés au moyen de la cmdlet Get-CsDialInConferencingAccessNumber.

Si vous avez importé des numéros d’accès de conférence rendez-vous à partir de Microsoft Office Communications Server 2007, ces numéros seront également extraits en exécutant la cmdlet Get-CsDialInConferencingAccessNumber et en insérant le paramètre Region. (Les numéros importés ne s’afficheront que si vous utilisez le paramètre Region.) Notez cependant qu’un message d’avertissement apparaîtra simultanément avec les URI (Uniform Resource Identifier) du numéro importé. Il s’agit là simplement de la manière dont la cmdlet gère les numéros d’accès de conférence rendez-vous.

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-CsDialInConferencingAccessNumber : RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. 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-CsDialInConferencingAccessNumber"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

Adresse SIP

Adresse SIP du numéro d’accès de conférence rendez-vous (c’est-à-dire l’objet de contact représentant ce numéro) à récupérer. Vous devez inclure le préfixe « sip: » au moment de spécifier le paramètre Identity (par exemple : -Identity sip:RedmondDialIn@litwareinc.com).

Si ce paramètre n’est pas spécifié, Get-CsDialInConferencingAccessNumber retourne tous les numéros d’accès de conférence rendez-vous configurés en vue d’une utilisation dans votre organisation.

Credential

Facultatif

Objet Credential PS

Permet d’exécuter la cmdlet Get-CsDialInConferencingAccessNumber avec d’autres informations d’identification. Ce paramètre peut être indispensable si le compte que vous avez utilisé pour vous connecter à Windows ne dispose pas des privilèges nécessaires pour manipuler les objets de contact.

Pour utiliser le paramètre Credential, vous devez d’abord créer un objet PSCredential à l’aide de la cmdlet Get-Credential. Pour plus d’informations, consultez la rubrique d’aide Get-Credential.

DomainController

Facultatif

Chaîne

Permet de vous connecter au contrôleur de domaine spécifié afin de récupérer des informations de contact. Pour vous connecter à un contrôleur de domaine spécifique, incluez le paramètre DomainController suivi du nom de l’ordinateur (par exemple, atl-mcs-001) ou son nom de domaine complet (par exemple, atl-mcs-001.litwareinc.com).

EmptyRegion

Facultatif

Paramètre de commutateur

Retourne des informations sur les plans de numérotation associés à une région qui n’est pas associée à un numéro d’accès de conférence rendez-vous au minimum. Par exemple, imaginons que le plan de numérotation Bellevue est associé à la région de Bellevue, mais qu’aucun numéro d’accès n’a été configuré pour cette même région. La région de Bellevue serait donc à considérer comme une région vide.

Ce paramètre ne peut être utilisé conjointement avec un autre paramètre.

Filter

Facultatif

Chaîne

Permet de limiter les données retournées en filtrant des attributs spécifiques pour Microsoft Lync Server 2010. Par exemple, il vous est possible de limiter les données retournées aux numéros de conférence rendez-vous affichant la valeur de chaîne "Redmond" dans leur nom complet, ou bien des numéros de conférence rendez-vous gratuits utilisant le préfixe 1-800.

Le paramètre Filter utilise la même syntaxe de filtrage Windows PowerShell que celle employée par la cmdlet Where-Object. Par exemple, un filtre qui retourne uniquement des numéros d’accès munis du préfixe 1-800 ressemblerait à ce qui suit : {LineUri -like "tel:+1800*"} où LineUri désigne l’attribut Active Directory, -like représente l’opérateur de comparaison, et "tel:+1800*" représente la valeur de filtre.

OU

Facultatif

Chaîne

Permet de récupérer des numéros d’accès à partir d’une unité d’organisation Active Directory spécifique. Ceci inclut les données provenant à la fois de l’unité d’organisation spécifiée et de toutes ses unités d’organisation enfants. Par exemple, si l’unité d’organisation Finance a deux unités d’organisation enfants, AccountsPayable et AccountsReceivable, les informations concernant les numéros d’accès proviendront de chacune de ces trois unités d’organisation.

Lorsque vous spécifiez une unité d’organisation, utilisez le nom unique de ce conteneur (par exemple : -OU "OU=Finance,dc=litwareinc,dc=com").

Region

Facultatif

Chaîne

Retourne tous les numéros d’accès de conférence rendez-vous associés à la région du plan de numérotation spécifiée. Par exemple, pour retourner tous les numéros d’accès de conférence rendez-vous pour la région « Northwest » (nord-ouest), utilisez la syntaxe suivante : -Region Northwest.

Vous pouvez également retourner des numéros d’accès qui ont été définis pour une étendue en particulier (ou au niveau de l’étendue globale) en insérant l’étendue dans la valeur du paramètre. Par exemple, pour retourner des numéros d’accès inhérents à la région Northwest et qui ont été définis au niveau de l’étendue du site de Redmond, utilisez la syntaxe suivante : -Region site:Redmond/Northwest. Notez que pour créer une référence à l’étendue Site, vous devez utiliser la propriété SiteId. Vous pouvez extraire les valeurs SiteId au moyen de la cmdlet Get-CsSite.

Pour retourner une liste des numéros d’accès qui ne sont pas associés au plan de numérotation, définissez la valeur de paramètre Region sur $Null : -Region $Null.

Notez que les numéros d’accès de conférence rendez-vous sont uniqement retournés selon la priorité qui leur a été affectée si vous spécifiez ce paramètre. L’ordre de priorité est le même que celui dans lequel les numéros apparaissent dans les invitations à des réunions et dans la page Web des conférences rendez-vous. Pour plus d’informations, consultez la rubrique d’aide Set-CsDialInConferencingAccessNumber.

ResultSize

Facultatif

Entier

Permet de limiter le nombre d’enregistrements retournés par une commande. Par exemple, pour retourner seulement sept numéros d’accès (indépendamment du nombre de numéros d’accès présents dans votre forêt), incluez simplement le paramètre ResultSize et définissez sa valeur sur 7. Notez qu’il est impossible de savoir quels seront les sept numéros d’accès retournés. Si vous attribuez au paramètre ResultSize la valeur 7 mais que votre forêt ne compte que trois numéros d’accès, la commande retournera ces trois numéros d’accès et se terminera sans erreur.

La taille des résultats peut être définie sur n’importe quel entier compris entre 0 et 2147483647 (inclus). Si le paramètre est défini sur 0, la commande sera exécutée mais aucune donnée ne sera retournée.

Types d’entrées

Chaîne. Get-CsDialInConferencingAccessNumber accepte une valeur de chaîne qui représente l’identité (paramètre Identity) du numéro d’accès.

Types de retours

Get-CsDialInConferencingAccessNumber retourne des instances de l’objet Microsoft.Rtc.Management.Xds.AccessNumber.

Exemple

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

Get-CsDialInConferencingAccessNumber

La commande présentée dans l’exemple 1 retourne une collection de tous les numéros d’accès de conférence rendez-vous configurés pour être utilisés dans l’organisation. L’appel de la cmdlet Get-CsDialInConferencingAccessNumber sans aucun paramètre supplémentaire permet de retourner une collection de tous les numéros d’accès de conférence rendez-vous.

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

Get-CsDialInConferencingAccessNumber -Identity sip:RedmondDialIn@litwareinc.com

Dans l’exemple 2, le numéro d’accès de conférence rendez-vous avec le paramètre Identity sip:RedmondDialIn@litwareinc.com est retourné. Parce que ces identités doivent être uniques, cette commande ne retourne jamais plus d’un numéro d’accès.

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

Get-CsDialInConferencingAccessNumber -Region "Redmond"

L’exemple 3 utilise le paramètre Region pour retourner tous les numéros d’accès de conférence rendez-vous associés à la région de Redmond. Pour ce faire, la cmdlet Get-CsDialInConferencingAccessNumber est appelée avec le paramètre Region. Une fois la valeur de paramètre « Redmond » définie, Get-CsDialInConferencingAccessNumber retourne tous les numéros où « Redmond » apparaît dans la liste des régions associées. Par exemple, un numéro d’accès répertoriant uniquement la région Redmond peut être retourné, de même qu’un numéro d’accès répertoriant à la fois Redmond et Paris.

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

Get-CsDialInConferencingAccessNumber -Region $Null

La commande ci-dessus retourne tous les numéros d’accès de conférence rendez-vous qui ne sont pas associés à une région (c’est-à-dire les numéros dont la propriété Region est vide).

-------------------------- Exemple 5 ------------------------

Get-CsDialInConferencingAccessNumber -Region site:USA/Redmond

La commande présentée dans l’exemple 5 retourne tous les numéros d’accès de conférence rendez-vous concernant la région de Redmond et définis au niveau de l’étendue du site USA (à savoir le site dont la propriété SiteId affiche la valeur site:USA).

-------------------------- Exemple 6 ------------------------

Get-CsDialInConferencingAccessNumber -Filter {DisplayName -like "*Seattle*"}

Dans l’exemple 6, le paramètre Filter est utilisé afin de retourner une collection de tous les numéros d’accès de conférence rendez-vous dont la propriété DisplayName incluent la chaîne « Seattle ». La valeur de filtre {DisplayName -like "*Seattle*"} limite les données retournées aux numéros d’accès dont la propriété DisplayName comprend le mot « Seattle » (par exemple, numéro d’accès de Seattle, numéro d’accès de conférence rendez-vous à Seattle, numéro d’accès Tacoma/Seattle, etc.).

-------------------------- Exemple 7 ------------------------

Get-CsDialInConferencingAccessNumber -Filter {LineUri -like "tel:+1425*"}

L’exemple 7 retourne tous les numéros d’accès de conférence rendez-vous dont les URI de ligne commencent par « tel:+1425 ». Tous les numéros de téléphone aux États-Unis dont l’indicatif régional est le 425 sont ainsi extraits. Pour cela, la cmdlet Get-CsDialInConferencingAccessNumber est appelée avec le paramètre Filter. La valeur de filtre {LineUri -like "tel:+1425*"} limite les données retournées aux URI de ligne qui débutent par la chaîne « tel:+1425 ». Pour retourner tous les numéros de téléphone dont l’indicatif est le 425 ou le 206, utilisez cette valeur de filtre :

{LineUri -like "tel:+1425*" -or LineUri -like "tel:+1206*"}

-------------------------- Exemple 8 ------------------------

Get-CsDialInConferencingAccessNumber | Where-Object {$_.PrimaryLanguage -eq "it-IT"}

L’exemple ci-dessus retourne une collection de tous les numéros d’accès de conférence rendez-vous dont la langue principale est l’italien. Pour réaliser cette tâche, la cmdlet Get-CsDialInConferencingAccessNumber est d’abord appelée afin de retourner une collection de tous les numéros d’accès configurés et utilisés dans l’organisation. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui sélectionne uniquement les numéros dont la propriété PrimaryLanguage est égale à « it-IT » (italien).

-------------------------- Exemple 9 ------------------------

Get-CsDialInConferencingAccessNumber  | Where-Object {$_.SecondaryLanguages -contains "fr-FR"}

La commande présentée dans l’exemple 9 retourne tous les numéros d’accès de conférence rendez-vous où le français est répertorié comme l’une des langues secondaires. Pour réaliser cette tâche, la cmdlet Get-CsDialInConferencingAccessNumber est d’abord appelée sans aucun paramètre. Elle retourne une collection complète de tous les numéros d’accès configurés pour être utilisés dans l’organisation. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui sélectionne uniquement les numéros dont la propriété SecondaryLanguages inclut une référence pour le français (fr-FR).