Compartir a través de

  • Artículo

Get-CsDialInConferencingAccessNumber

 

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

Devuelve información sobre todos los números de acceso a conferencias de acceso telefónico local que estén configurados para el uso en la organización La conferencia de acceso telefónico permite a los usuarios utilizar un teléfono móvil "normal", o un dispositivo de la red telefónica conmutada (RTC), para unirse a la parte de audio de una conferencia en línea.

Sintaxis

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>]

Descripción detallada

La conferencia de acceso telefónico permite a los usuarios emplear cualquier tipo de teléfono (una línea fija estándar, un teléfono móvil, un teléfono de voz sobre IP, etc.) para unirse a la parte de audio de una conferencia en línea. Esto permite a los usuarios participar en la reunión aunque no tengan un equipo ni conexión a Internet. Los usuarios disponen de todas las prestaciones de audio: pueden hablar con el resto de participantes y escuchar todo lo que sucede. Sin embargo, no podrán ver diapositivas compartidas, imágenes de vídeo ni elementos visuales.

Para ofrecer a los usuarios las prestaciones de conferencia de acceso telefónico, deberá crear números de acceso para conferencias de acceso telefónico: se trata de números de teléfono a los que los usuarios pueden llamar para conectarse a una reunión. Los números de acceso para conferencias de acceso telefónico se crean con el cmdlet New-CsDialInConferencingAccessNumber. Al crear un número de acceso para conferencia de acceso telefónico, en realidad, se crea un objeto de contacto en Active Directory Domain Services (AD DS); este objeto de contacto se usa para representar el número de acceso y todas sus propiedades. Para recuperar los números de contacto, use el cmdlet Get-CsDialInConferencingAccessNumber.

Si ha importado números de acceso de conferencia de acceso telefónico desde Microsoft Office Communications Server 2007, estos números se recuperarán también ejecutando Get-CsDialInConferencingAccessNumber e incluyendo el parámetro Region. (Los números importados no se mostrarán salvo que utilice el parámetro Region.) Sin embargo, tenga en cuenta que aparecerá un mensaje de advertencia junto con los Identificadores uniformes de recursos (URI) del número importado. Es solamente la manera en la que el cmdlet administra los números de acceso de conferencia de acceso telefónico importados.

Quién puede ejecutar este cmdlet: de forma predeterminada, están autorizados para ejecutar el cmdlet Get-CsDialInConferencingAccessNumber localmente los miembros de los siguientes grupos: RTCUniversalUserAdmins, RTCUniversalServerAdmins y RTCUniversalReadOnlyAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluidos los roles de RBAC personalizados que haya creado), ejecute el siguiente comando en el símbolo del sistema de Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Dirección SIP

Dirección SIP del número de acceso para conferencias de acceso telefónico (es decir, el objeto de contacto que representa dicho número) que se va a recuperar. Debe incluir el prefijo "sip:" al especificar la identidad; por ejemplo: -Identity sip:RedmondDialIn@litwareinc.com.

Si este parámetro no se especifica, Get-CsDialInConferencingAccessNumber devolverá todos los números de acceso a conferencias de acceso telefónico que estén configurados para usar en su organización.

Credential

Opcional

Objeto PSCredential

Permite ejecutar el cmdlet Get-CsDialInConferencingAccessNumber con credenciales alternativas. Esto puede ser necesario si la cuenta usada para iniciar sesión en Windows no tiene los privilegios necesarios para trabajar con objetos de contacto.

Para usar el parámetro Credential, primero debe crear un objeto PSCredential con el cmdlet Get-Credential. Si necesita información detallada, consulte el tema de ayuda Get-Credential.

DomainController

Opcional

Cadena de caracteres

Permite conectarse al controlador de dominio especificado para recuperar información de contactos. Para conectarse a un controlador de dominio específico, debe incluir el parámetro DomainController seguido del nombre del equipo (por ejemplo, atl-mcs-001) o su nombre de dominio completo (por ejemplo, atl-mcs-001.litwareinc.com).

EmptyRegion

Opcional

Parámetro modificador

Devuelve información sobre los planes de marcado asociados a una región que no está asociada con, al menos, un número de acceso de conferencia de acceso telefónico. Por ejemplo, imagine que el plan de marcado Bellevue está asociado con la región Bellevue, pero no se ha configurado ningún número de acceso para la región Bellevue. La región Bellevue se consideraría entonces una región vacía.

Este parámetro no se puede usar en combinación con otros parámetros.

Filter

Opcional

Cadena de caracteres

Permite limitar los datos que se devuelven filtrando los atributos específicos de Microsoft Lync Server 2010. Por ejemplo, puede limitar los datos devueltos a los números para conferencias de acceso telefónico que contengan el valor de cadena de caracteres "Redmond" en su nombre para mostrar o a los números para conferencias de acceso telefónico local gratuitos que usen el prefijo 1-800.

El parámetro Filter usa la misma sintaxis de filtrado de Windows PowerShell que usa el cmdlet Where-Object. Por ejemplo, un filtro que sólo devuelva números de acceso con el prefijo 1-800 tendría este aspecto: {LineUri -like "tel:+1800*"}, donde LineUri representa el atributo de Active Directory, -like representa el operador de comparación y "tel:+1800*" representa el valor de filtro.

OU

Opcional

Cadena de caracteres

Permite devolver números de acceso de una unidad organizativa (OU) de Active Directory específica. Incluye datos de la unidad organizativa principal especificada y cualquier otra OU que contenga. Por ejemplo, si la OU Finance contiene dos unidades organizativas (AccountsPayable y AccountsReceivable), se devolverá la información de números de acceso de las tres unidades organizativas.

Al especificar una OU, use el nombre distintivo del contenedor; por ejemplo: -OU "OU=Finance,dc=litwareinc,dc=com".

Region

Opcional

Cadena de caracteres

Devuelve todos los números de acceso para conferencias de acceso telefónico local que tengan la región de plan de marcado especificada. Por ejemplo, para devolver todos los número de acceso telefónico local para la región Northwest, use esta sintaxis: -Region Northwest.

También puede devolver números de acceso que se hayan asignado a un sitio en particular (o al ámbito global), si incluye el ámbito en el valor del parámetro. Por ejemplo, para devolver los números de acceso que utilizan la región Northwest, y que se hayan asignado al sitio Redmond, utilice esta sintaxis: -Region site:Redmond/Northwest. Tenga en cuenta que, al hacer referencia al ámbito de sitio, debe utilizar la propiedad SiteId. Puede recuperar valores de SiteId utilizando el cmdlet Get-CsSite.

Para devolver una lista de números de acceso que no estén asociados con ningún plan de marcado, defina el valor del parámetro Region como $Null: -Region $Null.

Tenga en cuenta que los números de acceso de conferencia de acceso telefónico sólo se devuelven en la prioridad que se les haya asignado, si se ha especificado este parámetro. El orden de prioridad es el mismo en el que aparecen los números en las invitaciones a reuniones y en la página web de conferencias de acceso telefónico. Si necesita información detallada, consulte el tema de ayuda Set-CsDialInConferencingAccessNumber.

ResultSize

Opcional

Entero

Permite restringir el número de registros que devuelve un comando. Por ejemplo, para que se devuelvan sólo siete números de acceso (al margen de la cantidad de números de acceso que haya en el bosque), simplemente, incluya el parámetro ResultSize y defina el valor 7. Tenga en cuenta que no es posible especificar qué 7 elementos se devolverán. Si se define ResultSize como 7 pero sólo tiene tres números de acceso en el bosque, el comando devolverá esos tres números y luego se completará sin errores.

El tamaño del resultado puede definirse en cualquier número entero entre 0 y 2147483647, ambos incluidos. Si se establece en 0, el comando se ejecutará pero no devolverá datos.

Tipos de entrada

Cadena de caracteres. Get-CsDialInConferencingAccessNumber acepta un valor alfanumérico que represente la identidad del número de acceso.

Tipos de valores devueltos

Get-CsDialInConferencingAccessNumber devuelve instancias del objeto Microsoft.Rtc.Management.Xds.AccessNumber.

Ejemplo

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

Get-CsDialInConferencingAccessNumber

El comando mostrado en el Ejemplo 1 devuelve una recopilación de todos los número de acceso para conferencias de acceso telefónico local que están configurados para su uso en la organización. Al llamar a Get-CsDialInConferencingAccessNumber sin parámetros adicionales, siempre se devuelve una recopilación de todos los números de acceso telefónico disponibles.

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

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

En el Ejemplo 2, se devuelve el número de acceso para conferencias de acceso telefónico local con la el valor de Identity sip:RedmondDialIn@litwareinc.com. Como las identidades deben ser únicas, este comando nunca devolverá más de un número de acceso.

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

Get-CsDialInConferencingAccessNumber -Region "Redmond"

En el Ejemplo 3 se usa el parámetro Region para devolver todos los números de acceso para conferencias de acceso telefónico que estén asociados con la región de Redmond. Para ello, se llama a Get-CsDialInConferencingAccessNumber junto con el parámetro Region. Al especificar "Redmond" como valor del parámetro, Get-CsDialInConferencingAccessNumber devuelve todos los números en los que "Redmond" aparezca en la lista de regiones asociadas. Por ejemplo, se devolvería un número de acceso que sólo tuviera Redmond como región, así como un número de acceso que tuviera Redmond y Portland.

-------------------------- Ejemplo 4 ------------------------

Get-CsDialInConferencingAccessNumber -Region $Null

El comando anterior devuelve todos los números de acceso para conferencias de acceso telefónico que no estén asociados con una región (es decir, cuya propiedad Region esté vacía).

-------------------------- Ejemplo 5 ------------------------

Get-CsDialInConferencingAccessNumber -Region site:USA/Redmond

El comando que se muestra en el Ejemplo 5 devuelve todos los números de acceso a conferencias de acceso telefónico de la región de Redmond que se hayan asignado al sitio USA (es decir, el sitio con SiteId site:USA).

-------------------------- Ejemplo 6 ------------------------

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

En el Ejemplo 6, se usa el parámetro Filter para devolver una recopilación de todos los números de acceso para conferencias de acceso telefónico que tengan el valor alfanumérico "Seattle" en DisplayName. El valor de filtro {DisplayName -like "*Seattle*"} restringe los datos devueltos a los números de acceso cuyo DisplayName contiene la palabra "Seattle" (por ejemplo, Número de acceso para Seattle, Número de acceso telefónico local para Seattle, Número de acceso para Tacoma/Seattle, etc.).

-------------------------- Ejemplo 7 ------------------------

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

En el Ejemplo 7 se devuelven todos los números de acceso para conferencias de acceso telefónico cuyo URI de línea empieza por +1425; de esta forma, se devuelven todos los números de acceso de EE.UU. con código de área 425. Para ello, se llama a Get-CsDialInConferencingAccessNumber con el parámetro Filter; el valor de filtro {LineUri -like "tel:+1425*"} restringe los datos devueltos a los URI de línea que empiezan por el valor alfanumérico "tel:+1425". Para devolver todos los números de teléfono del código de área 425 o del código de área 206, use este valor de filtro:

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

-------------------------- Ejemplo 8 ------------------------

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

En el ejemplo anterior se devuelve una recopilación de todos los números de acceso para conferencias de acceso telefónico local en que el idioma principal sea el italiano. Para llevar a cabo esta tarea, primero se llama a Get-CsDialInConferencingAccessNumber para devolver una recopilación de todos los números de acceso que estén configurados para su uso en la organización. Dicha recopilación se transfiere al cmdlet Where-Object, que únicamente selecciona los números cuya propiedad PrimaryLanguage sea igual a italiano ("it-It").

-------------------------- Ejemplo 9 ------------------------

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

El comando mostrado en el Ejemplo 9 devuelve todos los números de acceso para conferencias de acceso telefónico local en que el francés sea uno de los idiomas secundarios. Para llevar a cabo esta tarea, primero se llama a Get-CsDialInConferencingAccessNumber sin parámetros para devolver una recopilación completa de los números de acceso que estén configurados para usar en la organización. A continuación, esta recopilación se transfiere al cmdlet Where-Object, que únicamente selecciona los números cuya propiedad SecondaryLanguages incluya una entrada para francés (fr-FR).