Compartir a través de


Get-CsConferenceDirectory

 

Última modificación del tema: 2012-03-23

Devuelve información sobre los directorios de conferencia configurados en su organización. Los directorios de conferencia se usan para ayudar a los usuarios de conferencia de acceso telefónico local a localizar la información de conferencias.

Sintaxis

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

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

Descripción detallada

Al crear un Identificador Uniforme de Recursos (URI) de conferencia de acceso telefónico local, se le asigna direcciones SIP únicas. Sin embargo, las direcciones SIP resultan difíciles de convertir para los dispositivos no compatibles con SIP; por ejemplo, un teléfono de la red telefónica conmutada (RTC) no puede convertir una dirección SIP. Debido a esto, Microsoft Lync Server 2010 usa directorios de conferencia para ayudar a estos dispositivos a localizar y conectarse a las conferencias de acceso telefónico local. Esto se realiza creando un directorio de conferencia SIP que se asocia con cada URI de conferencia de acceso telefónico y se identifica con un valor entero en lugar de un URI de SIP. Los teléfonos de RTC y otros dispositivos pueden usar estos números (en lugar de un URI de SIP) cuando se conectan a conferencias; el número de directorio se incluye en la identificación de conferencia de RTC que escriben los usuarios cuando se conectan a una conferencia de acceso telefónico local.

El cmdlet Get-CsConferenceDirectory lo habilita para devolver información sobre todos los directorios de conferencia configurados en su organización.

Quiénes pueden ejecutar este cmdlet: De manera predeterminada, los miembros de los siguientes grupos están autorizados para ejecutar el cmdlet Get-CsConferenceDirectory en forma local: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Identificador numérico (por ejemplo, 7) del directorio de conferencia que debe devolverse. Si este parámetro se omite, Get-CsConferenceDirectory devuelve información sobre todos los directorios de conferencia en su organización.

Filter

Opcional

Cadena de caracteres

Le permite usar comodines para especificar la identidad del directorio de conferencia (o directorios) que deben recuperarse. Debido a que las identidades de directorio son numéricas, este parámetro puede ser de valor mínimo. Sin embargo, esta sintaxis devolverá todos los directorios de conferencia que tengan una identidad que comience con el número 3: -Filter "3*".

LocalStore

Opcional

Parámetro modificador

Recupera los datos del directorio de conferencias de la réplica local de Almacén de administración central, en lugar del propio Almacén de administración central.

Tipos de entrada

Ninguno. Get-CsConferenceDirectory no acepta entradas canalizadas.

Tipos de valores devueltos

Get-CsConferenceDirectory devuelve instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.PstnConf.ConferenceDirectories.

Ejemplo

-------------------------- Ejemplo 1 --------------------------

Get-CsConferenceDirectory

El comando que se muestra en el Ejemplo 1 devuelve información sobre todos los directorios de conferencia configurados en su organización.

-------------------------- Ejemplo 2 --------------------------

Get-CsConferenceDirectory -Identity 2

El Ejemplo 2 devuelve información sobre el directorio de conferencia con la identidad 2. Debido a que las identidades deben ser únicas, este comando nunca devolverá más de un único directorio de conferencia.

-------------------------- Ejemplo 3 --------------------------

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

El comando anterior devuelve todos los directorios de conferencia que se hospedan en el servicio UserServer:atl-cs-001.litwareinc.com. Para esto, el comando primero llama a Get-CsConferenceDirectory sin ningún parámetro para devolver una recopilación de todos los directorios de conferencia que se encuentran en su organización. A continuación, esta recopilación se canaliza al cmdlet Where-Object, que selecciona únicamente esos directorios en que el ServiceID coincide con el valor "UserServer:atl-cs-001.litwareinc.com".