New-CsDialInConferencingAccessNumber
Última modificación del tema: 2012-03-23
Crea un número de acceso para conferencia de acceso telefónico local. La conferencia de acceso telefónico local permite a los usuarios usar un teléfono "normal", un móvil u otro dispositivo de la red telefónica conmutada (RTC), para unirse al audio de una conferencia.
Sintaxis
New-CsDialInConferencingAccessNumber -DisplayNumber <String> -LineURI <String> -Pool <Fqdn> -PrimaryLanguage <String> -PrimaryUri <String> -Regions <MultiValuedProperty> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-PassThru <SwitchParameter>] [-ScopeToSite <SwitchParameter>] [-SecondaryLanguages <MultiValuedProperty>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
La conferencia de acceso telefónico local permite a los usuarios emplear cualquier tipo de teléfono (como una línea terrestre estándar, un teléfono móvil, un teléfono de voz sobre IP (VoIP), 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. Lo único que no podrán hacer es ver diapositivas compartidas, imágenes de vídeo ni elementos visuales.
Para ofrecer a los usuarios las prestaciones de conferencia de acceso telefónico local, deberá crear números de acceso para conferencias de acceso telefónico local: 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 local se crean con el cmdlet New-CsDialInConferencingAccessNumber. Al crear un número de acceso para conferencia de acceso telefónico local, 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.
Al crear un número de acceso telefónico, es necesario incluir los parámetros siguientes: PrimaryUri; LineURI; Pool; DisplayNumber; PrimaryLanguage; y Regions. Todos estos parámetros (y sus valores) son bastante sencillos, probablemente, con una excepción: las regiones. Al crear un número de acceso, éste debe asociarse con una o más regiones. Además, una región no puede asociarse con un número de conferencia de acceso telefónico local, a menos que dicha región aparezca, como mínimo, en un plan de marcado. Si una región aparece en la propiedad DialInConferencingRegion de al menos un plan de marcado, puede asociarse con un número de acceso. De lo contrario, no puede asociarse con un número de acceso. Lo que significa, sencillamente, que primero tiene que crear un plan de marcado y especificar una región para el mismo para poder crear un número de acceso de conferencia de acceso telefónico.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet New-CsDialInConferencingAccessNumber de forma local: RTCUniversalServerAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluido cualquier otro rol RBAC personalizado que usted mismo haya creado), ejecute el siguiente comando desde Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsDialInConferencingAccessNumber"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
PrimaryUri |
Requerido |
Dirección SIP |
Dirección SIP única que se debe asignar al nuevo objeto de contacto. Al especificar el parámetro PrimaryUri debe incluir el prefijo "sip:" "sip:" Por ejemplo: -PrimaryUri " sip:RedmondDialIn@litwareinc.com". |
DisplayName |
Opcional |
Cadena de caracteres |
Nombre para mostrar de Active Directory del nuevo objeto de contacto. Este es el nombre que se mostrará en Microsoft Lync 2010. |
DisplayNumber |
Requerido |
Cadena de caracteres |
El número de teléfono como se muestra en las invitaciones a reuniones y en la página web de conferencia de acceso telefónico. Puede dar el formato que prefiera al parámetro DisplayNumber; por ejemplo, 1-800-555-1234; 1-(800)-555-1234; o 1.800.555.1234. |
LineURI |
Requerido |
Cadena de caracteres |
El número de acceso real para conferencia de acceso telefónico local. El parámetro LineURI debe especificarse usando la sintaxis siguiente: el prefijo tel: seguido de un signo más (+) y del código del país/región, el código de área y el número de teléfono. Por ejemplo: tel:+18005551234. Tenga en cuenta que los espacios, guiones, paréntesis y otros caracteres no están permitidos. Los valores de LineURI deben ser únicos en Active Directory. |
Regions |
Requerido |
Cadena de caracteres |
Regiones de plan de marcado asociadas con el número de acceso telefónico local. Si una región no está incluida por lo menos en un plan de marcado, no puede asociarse con un número de acceso para conferencia de acceso telefónico local. Para especificar varias regiones, use una lista separada por comas: -Regions "Northwest", "Southwest" |
Pool |
Requerido |
FQDN |
Grupo principal del nuevo objeto de contacto. |
PrimaryLanguage |
Requerido |
Cadena de caracteres |
Idioma principal usado para los anuncios de conferencias de acceso telefónico local. El idioma debe configurarse con uno de los códigos de idioma disponibles para conferencias de acceso telefónico local; por ejemplo, en-US para inglés de EE.UU., fr-FR para francés, etc. Para devolver una lista de los códigos de idioma disponibles, escriba el comando siguiente en el símbolo del sistema de Windows PowerShell: Get-CsDialInConferencingLanguageList | Select-Object -ExpandProperty Languages. |
SecondaryLanguages |
Opcional |
Matriz de cadena de caracteres |
Recopilación de idiomas opcional que también se puede usar para los anuncios de conferencias de acceso telefónico local. Los idiomas secundarios deben configurarse como una lista de códigos de idioma separados por comas; por ejemplo, la sintaxis siguiente define el francés de Canadá y el francés como idiomas secundarios: -SecondaryLanguages "fr-CA", "fr-FR". Un solo número de acceso puede tener hasta cuatro idiomas secundarios. |
ScopeToSite |
Opcional |
Parámetro modificador |
Si está presente, el nuevo número se asignará al ámbito del mismo sitio donde se encuentra el grupo principal del objeto de contacto. Si no se incluye el parámetro ScopeToSite, el nuevo número se asignará al ámbito global. |
PassThru |
Opcional |
Parámetro modificador |
Permite transferir un objeto de contacto mediante la canalización que representa el nuevo número de acceso para conferencia de acceso telefónico local. De forma predeterminada, el cmdlet New-CsDialInConferencingAccessNumber no transfiere objetos a través de la canalización. |
Tenant |
Opcional |
Identificador único global |
Este parámetro no se aplica a la versión interna de Lync Server 2010. |
WhatIf |
Opcional |
Parámetro modificador |
Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente. |
Confirm |
Opcional |
Parámetro modificador |
Solicita confirmación antes de ejecutar el comando. |
Tipos de entrada
Ninguno. New-CsDialInConferencingAccessNumber no acepta la entrada transferida.
Tipos de valores devueltos
New-CsDialInConferencingAccessNumber crea instancias del objeto Microsoft.Rtc.Management.Xds.AccessNumber.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
New-CsDialInConferencingAccessNumber -PrimaryUri "sip:RedmondDialIn@litwareinc.com" -DisplayNumber "1-800-555-1234" -LineUri "tel:+18005551234" -Pool atl-cs-001.litwareinc.com -PrimaryLanguage "en-US" -Regions "Redmond"
En el Ejemplo 1 se crea un número de acceso para conferencia de acceso telefónico local con el URI primario sip:RedmondDialIn@litwareinc.com. Además del parámetro PrimaryUri, el comando incluye parámetros que configuran el número de teléfono tal y como se muestra en Microsoft Lync 2010 (DisplayNumber), el número de teléfono en el formato E.164 (LineUri), el grupo de registrador al que se asigna el nuevo número (-Pool), el idioma principal del número (PrimaryLanguage) y la región a la que se asigna el nuevo número (Regions).
-------------------------- Ejemplo 2 ------------------------
New-CsDialInConferencingAccessNumber -PrimaryUri "sip:RedmondDialIn@litwareinc.com" -DisplayNumber "1-800-555-1234" -LineUri "tel:+18005551234" -Pool atl-cs-001.litwareinc.com -PrimaryLanguage "en-US" -Regions "Redmond" -SecondaryLanguages "fr-CA", "fr-FR"
El comando mostrado en el Ejemplo 2 es una variación del comando mostrado en el Ejemplo 1; la única diferencia es que el comando de este ejemplo también asigna dos idiomas secundarios (francés de Canadá y francés) al nuevo número de acceso para conferencia de acceso telefónico local. Para asignar los idiomas secundarios, se incluye el parámetro SecondaryLanguages junto con una lista separada por comas con los idiomas que se deben asignar (fr-CA y fr-FR).
-------------------------- Ejemplo 3 ------------------------
New-CsDialInConferencingAccessNumber -PrimaryUri "sip:RedmondDialIn@litwareinc.com" -DisplayNumber "1-800-555-1234" -LineUri "tel:+18005551234" -Pool atl-cs-001.litwareinc.com -PrimaryLanguage "en-US" -Regions "Redmond" -ScopeToSite
El comando anterior crea un nuevo número de acceso de conferencia de acceso telefónico local se asignará al ámbito del sitio en el que se localiza el grupo principal del objeto de contacto. Para ello, el comando incluye el parámetro ScopeToSite.
Vea también
Otros recursos
Get-CsDialInConferencingAccessNumber
Remove-CsDialInConferencingAccessNumber
Set-CsDialInConferencingAccessNumber