Partager via

  • Article

Get-CsConferenceDirectory

 

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

Retourne des informations sur les annuaires de conférences configurés pour être utilisés dans votre organisation. Les annuaires des conférences permettent aux utilisateurs de conférence rendez-vous de rechercher plus facilement des informations sur une conférence.

Syntaxe

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

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

Description détaillée

Lorsque vous créez un URI (Uniform Resource Identifier) de conférence rendez-vous, une adresse SIP unique lui est attribuée. Cependant, les adresses SIP sont difficiles à traduire pour les périphériques non compatibles SIP ; par exemple, un téléphone de réseau téléphonique commuté (PSTN) ne peut pas traduire une adresse SIP. De ce fait, Microsoft Lync Server 2010 utilise les annuaires des conférences pour aider ces périphériques à trouver des conférences rendez-vous et à s’y connecter. Pour cela, il crée un annuaire de conférences SIP qui est associé à chaque URI de conférence rendez-vous et identifié par un entier et non par un URI SIP. Les téléphones PSTN et autres périphériques peuvent alors utiliser ces numéros (à la place des URI SIP) lorsqu’ils se connectent aux conférences ; concrètement, le numéro d’annuaire est inclus dans l’identification de conférence PSTN que les utilisateurs fournissent lorsqu’ils se connectent à une conférence rendez-vous.

La cmdlet Get-CsConferenceDirectory vous permet de retourner des informations sur tous les annuaires des conférences configurés pour être utilisés dans votre organisation.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identificateur numérique (par exemple 7) de l’annuaire de conférences à retourner. Si ce paramètre est omis, Get-CsConferenceDirectory retourne des informations sur tous les annuaires des conférences utilisés dans votre organisation.

Filter

Facultatif

Chaîne

Vous permet d’utiliser des caractères génériques pour spécifier la propriété Identity de l’annuaire ou des annuaires des conférences à récupérer. Étant donné que les propriétés Identities des annuaires ont des valeurs numériques, ce paramètre peut être de valeur minime. Toutefois, cette syntaxe retournera tous les annuaires des conférences qui ont une propriété commençant par 3 : -Filter "3*".

LocalStore

Facultatif

Paramètre de commutateur

Récupère les données de l’annuaire de conférences à partir de la réplique locale du magasin central de gestion, au lieu du magasin central de gestion lui-même.

Types d’entrées

Aucun. Get-CsConferenceDirectory n’accepte pas la saisie de données transmises via le pipeline.

Types de retours

Get-CsConferenceDirectory retourne des instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.PstnConf.ConferenceDirectories.

Exemple

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

Get-CsConferenceDirectory

La commande illustrée dans l’exemple 1 retourne des informations sur tous les annuaires des conférences configurés pour être utilisés dans votre organisation.

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

Get-CsConferenceDirectory -Identity 2

L’exemple 2 retourne des informations sur l’annuaire de conférences dont la propriété Identity est 2. Étant donné que les identités doivent être uniques, cette commande ne retournera jamais plus d’un annuaire de conférences.

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

Get-CsConferenceDirectory | Where-Object {$_.ServiceID -match "UserServer:atl-cs-001.litwareinc.com"}

La commande ci-dessus retourne tous les annuaires des conférences hébergés sur le service UserServer:atl-cs-001.litwareinc.com. Pour cela, la commande appelle d’abord Get-CsConferenceDirectory sans paramètre afin de retourner une collection de tous les annuaires des conférences de votre organisation. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui sélectionne uniquement les annuaires pour lesquels le ServiceID correspond à la valeur de chaîne à UserServer:atl-cs-001.litwareinc.com.