Set-CsDialInConferencingAccessNumber
Última modificación del tema: 2012-03-27
Modifica los valores de propiedad de un número de acceso de conferencia de acceso telefónico. La conferencia de acceso telefónico local permite a los usuarios usar un teléfono "normal", móvil u otro dispositivo de la red telefónica conmutada (RTC), para unirse a la parte de audio de una conferencia.
Sintaxis
Set-CsDialInConferencingAccessNumber -Instance <AccessNumber> [-Confirm [<SwitchParameter>]] [-PassThru <SwitchParameter>] [-ScopeToGlobal <SwitchParameter>] [-ScopeToSite <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Set-CsDialInConferencingAccessNumber -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayNumber <String>] [-LineUri <String>] [-PassThru <SwitchParameter>] [-PrimaryLanguage <String>] [-Regions <MultiValuedProperty>] [-ScopeToGlobal <SwitchParameter>] [-ScopeToSite <SwitchParameter>] [-SecondaryLanguages <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]]
Set-CsDialInConferencingAccessNumber -Identity <UserIdParameter> -Priority <Int32> -ReorderedRegion <String> [-Confirm [<SwitchParameter>]] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
La conferencia de acceso telefónico local habilita a los usuarios para emplear cualquier tipo de teléfono (por ejemplo, una "línea terrestre" 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. Esto permite a los usuarios participar en la reunión incluso si no tienen un equipo o conexión a Internet. Los usuarios de acceso telefónico local disponen de todas las capacidades de audio: pueden hablar con otros participantes y escuchar todo lo que ocurre; lo único que no podrán hacer es ver diapositivas compartidas, imágenes de video ni elementos visuales.
Para ofrecer a los usuarios las capacidades de conferencia de acceso telefónico local, deberá crear números de acceso para conferencias de acceso telefónico local: Los usuarios de números de teléfono 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.
Después de haber creado el número de conferencia de acceso telefónico local, puede usar el cmdlet Set-CsDialInConferencingAccessNumber para modificar las propiedades de ese número. Por ejemplo, puede cambiar cosas como el propio número de teléfono (LineUri) o el nombre para mostrar para el objeto de contacto que representa ese número. Además, Set-CsDialInConferencingAccessNumber lo habilita para modificar el ámbito del número; por ejemplo, puede usar este cmdlet para tomar un número que se ha asignado al ámbito global y reasignarlo al ámbito del sitio.
Quiénes pueden ejecutar este cmdlet: De manera predeterminada, los miembros de los siguientes grupos están autorizados para ejecutar el cmdlet Set-CsDialInConferencingAccessNumber en forma local: 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 "Set-CsDialInConferencingAccessNumber"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
Dirección SIP |
La dirección SIP del objeto de contacto que representa el número de conferencia de acceso telefónico. Cuando especifique la identidad, debe incluir el prefijo "sip:"; por ejemplo: -Identity " sip:RedmondDialIn@litwareinc.com". |
Instance |
Opcional |
Permite enviar una referencia a un objeto al cmdlet, en lugar de definir valores de parámetros individuales. |
|
DisplayName |
Opcional |
Cadena de caracteres |
Nombre para mostrar de Active Directory para el nuevo objeto de contacto. Este es el nombre que también se mostrará en Microsoft Lync 2010. |
DisplayNumber |
Requerido |
Cadena de caracteres |
Número de teléfono tal y como se muestra en las invitaciones a la reunión y en la página web de las configuraciones de conferencias de acceso telefónico local. 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 |
Opcional |
Cadena de caracteres |
El número de teléfono de conferencia de acceso telefónico real. El parámetro LineUri debe especificarse mediante la siguiente sintaxis: El prefijo de tel.: prefijo seguido de un signo más (+) y del código del país/región, el código de llamada, el código de área y el número de teléfono. Por ejemplo: tel:+18005551234. No están permitidos los espacios, guiones, paréntesis y otros caracteres. |
PassThru |
Opcional |
Parámetro modificador |
Permite enviar un objeto de contacto mediante la transferencia que representa el número modificado de acceso para conferencia de acceso telefónico local. De forma predeterminada, el cmdlet Set-CsDialInConferencingAccessNumber no envía objetos a través de la transferencia. |
PrimaryLanguage |
Opcional |
Cadena de caracteres |
Lenguaje primario usado para anuncios de conferencia de acceso telefónico. 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 los EE. UU. o fr-FR para francés. Para devolver una lista de los códigos de idioma disponibles, escriba el siguiente comando en el aviso de Windows PowerShell: Get-CsDialInConferencingLanguageList | Select-Object -ExpandProperty Languages. |
Priority |
Opcional |
Integer |
Lo habilita para cambiar el orden en que se presentan los números de conferencia de acceso telefónico local a los usuarios de invitaciones a reuniones o cuando tienen acceso a la página web de la configuración de la conferencia de acceso telefónico local. A los números inferiores se les da mayor prioridad; para que aparezca un número al comienzo de la lista, establezca la prioridad en 0. Tenga en cuenta que si cambia la prioridad de un número determinado, también debe usar el parámetro ReorderedRegion para indicar la región en que la prioridad modificada debe tomar efecto. |
Regions |
Opcional |
Cadena de caracteres |
Regiones del plan de marcado asociadas con el número de acceso telefónico. 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 con comas: -Regions "Northwest", "Southwest" |
ReorderedRegion |
Opcional |
Cadena de caracteres |
Usada con el parámetro Priority cuando se cambia la prioridad de un número de conferencia de acceso telefónico local en una región. El parámetro ReorderedRegion indica la región en que debe realizarse el reordenamiento de prioridad; por ejemplo: -ReorderedRegion "Redmond". |
ScopeToGlobal |
Opcional |
Parámetro modificador |
Si está presente, el número de conferencia de acceso telefónico se asignará al ámbito global. |
ScopeToSite |
Opcional |
Parámetro modificador |
Si está presente, el número de conferencia de acceso telefónico local se limita al sitio donde reside el grupo de registrador del objeto de contacto. |
SecondaryLanguages |
Opcional |
Colección de cadenas |
También se puede usar una recopilación opcional de idiomas para realizar anuncios de conferencia de acceso telefónico. Deben configurarse idiomas secundarios como una lista separada por comas de códigos de idioma; por ejemplo, la siguiente sintaxis establece el francés canadiense y el francés como idiomas secundarios; -SecondaryLanguages "fr-CA", "fr-FR". Un número de acceso puede asociarse con un máximo cuatro 4 idiomas secundarios. |
WhatIf |
Opcional |
Parámetro modificador |
Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente. |
Confirm |
Parámetro modificador |
Solicita confirmación antes de ejecutar el comando. |
Tipos de entrada
Objeto Microsoft.Rtc.Management.Xds.AccessNumber. Set-CsDialInConferencingAccessNumber acepta entradas canalizadas del objeto de números de acceso.
Tipos de valores devueltos
Set-CsDialInConferencingAccessNumber no devuelve un valor ni un objeto. En su lugar, el cmdlet configura instancias del objeto Microsoft.Rtc.Management.Xds.AccessNumber.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Set-CsDialInConferencingAccessNumber -Identity "sip:RedmondDialIn@litwareinc.com" -DisplayName "Redmond Dial-In Access Number"
El comando que se muestra en el Ejemplo 1 modifica la propiedad DisplayName para el número de acceso a conferencia de acceso telefónico con el valor Identity sip:RedmondDialIn@litwareinc.com. En este ejemplo, el nombre para mostrar se establece como "Redmond Dial-In Access Number".
-------------------------- Ejemplo 2 --------------------------
Set-CsDialInConferencingAccessNumber -Identity "sip:RedmondDialIn@litwareinc.com" -Regions "Redmond", "Seattle"
En el Ejemplo 2, el número de acceso a conferencia de acceso telefónico con el valor Identity sip:RedmondDialIn@litwareinc.com se modifica para incluir dos regiones: Redmond y Seattle. Para ello, se llama al parámetro Regions, seguido de las dos regiones (dos valores de cadena separados por comas). Tenga en cuenta que este comando producirá un error a menos que las regiones de Redmond y Seattle ya se hayan definido en planes de marcado.
-------------------------- Ejemplo 3 --------------------------
Get-CsDialInConferencingAccessNumber | Where-Object {$_.PrimaryLanguage -eq "fr-FR"}| Set-CsDialInConferencingAccessNumber -SecondaryLanguages "fr-CA"
En el ejemplo anterior, todos los números de acceso a conferencia de acceso telefónico local en que el idioma principal es francés se modifican para usar el francés canadiense como el idioma secundario. A fin de realizar esta tarea, se llama primero a Get-CsDialInConferencingAccessNumber para devolver una recopilación de todos los números de acceso telefónico local configurados en la organización. A continuación, esta recopilación se canaliza al cmdlet Where-Object, que selecciona los números de acceso cuya propiedad PrimaryLanguage es igual a French ("fr-FR"). A continuación, esta recopilación filtrada se canaliza a Set-CsDialInConferencingAccessNumber, que establece el valor de la propiedad SecondaryLanguages a francés canadiense ("fr-CA").
-------------------------- Ejemplo 4 --------------------------
Get-CsDialInConferencingAccessNumber -Filter {DisplayName -eq "Default DialIn Access Number"} | Set-CsDialInConferencingAccessNumber -DisplayName "Litwareinc Conferencing"
El comando que se muestra en el Ejemplo 4 cambia el nombre para mostrar de Active Directory para el número de acceso a conferencia de acceso telefónico especificado. Para ello, el comando primero usa Get-CsDialInConferencingAccessNumber y el parámetro Filter para devolver el número de acceso telefónico local cuya propiedad DisplayName sea igual a "Default DialIn Access Number". Ese número de acceso luego se canaliza al cmdlet Set-CsDialInConferencingAccessNumber, que cambia el nombre para mostrar a Litwareinc Conferencing.
-------------------------- Ejemplo 5 --------------------------
Get-CsDialInConferencingAccessNumber -Filter {LineUri -eq "TEL:+14255558715"} | Set-CsDialInConferencingAccessNumber -DisplayNumber "1-425-555-1298" -LineUri "tel:+14255551298"
En el Ejemplo 5, tanto el número para mostrar como el Identificador Uniforme de Recursos (URI) de línea se modifican para el número de acceso de conferencia de acceso telefónico local especificado. Para recuperar el número que debe modificarse, el comando primero usa Get-CsDialInConferencingAccessNumber y el parámetro Filter; el valor de filtro correspondiente limita los datos devueltos al número de acceso cuya propiedad LineUri es igual a (-eq) TEL:+14255558715. Ese número de acceso luego se canaliza a Set-CsDialInConferencingAccessNumber, que a su vez modifica a ambas propiedades DisplayNumber y LineUri del número de acceso.
-------------------------- Ejemplo 6 --------------------------
Get-CsDialInConferencingAccessNumber | Where-Object {$_.PrimaryLanguage -ne "en-US"} | Set-CsDialInConferencingAccessNumber -SecondaryLanguages "fr-FR","it-IT"
El comando anterior asigna un par de idiomas secundarios a todos los números de acceso a conferencia de acceso telefónico local que no usan el inglés estadounidense como su idioma primario. Para ello, el comando primero llama a Get-CsDialInConferencingAccessNumber para devolver una recopilación de todos los números de acceso a conferencia de acceso telefónico local configurados en la organización. A continuación, esta recopilación se canaliza al cmdlet Where-Object, que selecciona únicamente aquellos números cuya propiedad PrimaryLanguage no sea igual a inglés estadounidense (en-US). A continuación, la recopilación filtrada se canaliza a Set-CsDialInConferencingAccessNumber, que usa el parámetro -SecondaryLanguages para asignar a cada número en la recopilación los idiomas secundarios francés (fr-FR) e italiano (it-IT).
-------------------------- Ejemplo 7 ------------------------
Get-CsDialInConferencingAccessNumber -Identity ""sip:RedmondDialIn@litwareinc.com"" -Priority 0 -ReorderedRegion Redmond
El comando que se muestra en el Ejemplo 7 asigna al número de conferencias de acceso telefónico local "sip:RedmondDialIn@litwareinc.com" la prioridad más alta de la región Redmond; como resultado, el número se ubica primero en la lista de invitaciones a reuniones y en la página web de conferencias de acceso telefónico local. Para establecer la prioridad, se incluye el parámetro Priority junto con el valor 0 del parámetro. (El número de acceso de prioridad más alta tiene un valor Priority de 0, el número que ocupa la prioridad número 2 tiene un valor Priority de 1, etc.). Además, se incluye el parámetro ReorderedRegion para indicar que las prioridades de números de acceso se cambiarán dentro de la región Redmond.
Vea también
Otros recursos
Get-CsDialInConferencingAccessNumber
New-CsDialInConferencingAccessNumber
Remove-CsDialInConferencingAccessNumber