通过

  • 项目

Set-CsDialInConferencingAccessNumber

 

上一次修改主题： 2012-03-27

修改现有电话拨入式会议接入号码的属性值。电话拨入式会议为用户提供了一种使用“常规”电话、移动电话或公用电话交换网 (PSTN) 上的其他设备加入会议的音频部分的方法。

语法

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

详细说明

电话拨入式会议允许用户使用任何类型的电话（例如，标准的“有线电话”、移动电话或 IP 语音 (VoIP) 电话等）加入会议的音频部分。这样，用户即使没有计算机或 Internet 连接，也可以参加会议。电话拨入式用户具备完整的音频功能：他们能与其他与会者通话，并能听到所有内容；只是无法看到共享幻灯片、视频播放或其他可视元素。

为了向用户提供电话拨入式会议功能，必须创建电话拨入式会议访问号码：即用户为了连接到会议可以呼叫的电话号码。电话拨入式会议访问号码是使用 New-CsDialInConferencingAccessNumber cmdlet 创建的。创建新的电话拨入式会议访问号码时，实际上是在 Active Directory 域服务 (AD DS) 中创建一个新的联系人对象。该联系人对象用于代表该访问号码及其所有属性。

创建电话拨入式会议号码之后，您可以使用 Set-CsDialInConferencingAccessNumber cmdlet 修改该号码的属性。例如，您可以更改电话号码 (LineUri) 本身等属性；还可以更改代表该号码的联系对象的显示名称。此外，使用 Set-CsDialInConferencingAccessNumber 可以修改号码的作用域。例如，您可以使用此 cmdlet 取得已分配给 global 作用域的号码，然后将其重新分配给 site 作用域。

谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Set-CsDialInConferencingAccessNumber cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：

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

参数

参数 必需 类型 描述

Identity

必需

SIP 地址

代表电话拨入式会议号码的联系对象的 SIP 地址。指定 Identity 时，您必须加入“sip:”前缀，例如：-Identity " sip:RedmondDialIn@litwareinc.com"。

Instance

可选

允许您将对对象的引用传递到 cmdlet，而不是设置单个参数值。

DisplayName

可选

字符串

新联系对象的 Active Directory 显示名称。此名称还是将显示在 Microsoft Lync 2010 中的名称。

DisplayNumber

必需

字符串

显示在会议邀请和电话拨入式会议设置网页中的电话号码。您可以采用所喜欢的任意方式设置 DisplayNumber 的格式；例如 1-800-555-1234、1-(800)-555-1234 或 1.800.555.1234。

LineUri

可选

字符串

实际的电话拨入式会议电话号码。必须使用以下语法指定 LineUri：“tel:”前缀后跟加号 (+)，然后依次再跟国家/地区代码、区号和电话号码。例如：tel:+18005551234。不允许使用空格、连字符、括号和其他字符。

PassThru

可选

开关参数

用于通过表示修改的电话拨入式会议访问号码的管道传递联系人对象。默认情况下，Set-CsDialInConferencingAccessNumber cmdlet 不通过管道传递对象。

PrimaryLanguage

可选

字符串

发出电话拨入式会议通知所采用的主要语言。必须使用一种可用的电话拨入式会议语言代码配置该语言；例如，en-US（表示美国英语）或 fr-FR（表示法语）等。要返回可用语言代码的列表，请在 Windows PowerShell 提示符处键入以下命令：

Get-CsDialInConferencingLanguageList | Select-Object -ExpandProperty Languages。

Priority

可选

整数

使您可以更改会议邀请中或访问电话拨入式会议设置网页时呈现给用户的电话拨入式会议号码的顺序。数字越小，优先级越高；要使号码出现在列表首位，请将优先级设置为 0。注意，如果更改了给定号码的优先级，还必须使用 ReorderedRegion 参数指示修改后的优先级应生效的地区。

Regions

可选

字符串

与拨入号码关联的拨号计划地区。如果某个地区未包含在至少一个拨号计划中，则不能将该地区与电话拨入式会议访问号码相关联。要指定多个地区，请使用逗号分隔列表：-Regions "Northwest", "Southwest"

ReorderedRegion

可选

字符串

更改某个地区电话拨入式会议号码的优先级时与 Priority 参数配合使用。ReorderedRegion 参数指示要进行优先级重新排序的地区，例如：-ReorderedRegion "Redmond"。

ScopeToGlobal

可选

开关参数

如果加入此参数，则电话拨入式会议号码将分配给全局作用域。

ScopeToSite

可选

开关参数

如果加入此参数，电话拨入式会议号码的作用域将为联系对象的注册器池所在的站点。

SecondaryLanguages

可选

字符串集合

同样可用于发出电话拨入式会议通知的可选语言集合。辅助语言必须配置为以逗号分隔的语言代码列表；例如，以下语法设置加拿大法语和法国法语作为辅助语言：-SecondaryLanguages "fr-CA", "fr-FR"。

一个接入号码可以与 4 种辅助语言关联。

WhatIf

可选

开关参数

描述如果执行命令会发生什么情况（无需实际执行命令）。

Confirm

开关参数

在执行命令之前提示您进行确认。

输入类型

Microsoft.Rtc.Management.Xds.AccessNumber 对象。Set-CsDialInConferencingAccessNumber 接受通过管道传递的访问号码对象的输入。

返回类型

Set-CsDialInConferencingAccessNumber 并不返回值或对象。但此 cmdlet 会配置 Microsoft.Rtc.Management.Xds.AccessNumber 对象的实例。

示例

-------------------------- 示例 1 ------------------------

Set-CsDialInConferencingAccessNumber -Identity "sip:RedmondDialIn@litwareinc.com" -DisplayName "Redmond Dial-In Access Number"

示例 1 所示的命令修改了 Identity 为 sip:RedmondDialIn@litwareinc.com 的电话拨入式会议接入号码的 DisplayName 属性。在此示例中，显示名称设置为“Redmond Dial-In Access Number”。

-------------------------- 示例 2 ------------------------

Set-CsDialInConferencingAccessNumber -Identity "sip:RedmondDialIn@litwareinc.com" -Regions "Redmond", "Seattle"

在示例 2 中，Identity 为 sip:RedmondDialIn@litwareinc.com 的电话拨入式会议接入号码经修改后包含以下两个地区：Redmond 和 Seattle。为执行此操作，命令调用了 Regions 参数，后跟这两个地区（以逗号分隔的两个字符串值）。注意，除非已在拨号计划中定义了 Redmond 和 Seattle 这两个地区，否则此命令将失败。

-------------------------- 示例 3 ------------------------

Get-CsDialInConferencingAccessNumber | Where-Object {$_.PrimaryLanguage -eq "fr-FR"}| Set-CsDialInConferencingAccessNumber -SecondaryLanguages "fr-CA"

在上述示例中，主要语言为法国法语的所有电话拨入式会议接入号码经修改后使用加拿大法语作为辅助语言。为实现此任务，命令首先调用 Get-CsDialInConferencingAccessNumber，以返回所有配置为在组织中使用的电话拨入式接入号码的集合。然后，将此集合通过管道传递给 Where-Object cmdlet，后者选取 PrimaryLanguage 属性等于法国法语 ("fr-FR") 的接入号码。接下来，将筛选出的集合通过管道传递给 Set-CsDialInConferencingAccessNumber，后者将 SecondaryLanguages 属性的值设置为加拿大法语 ("fr-CA")。

-------------------------- 示例 4 ------------------------

Get-CsDialInConferencingAccessNumber -Filter {DisplayName -eq "Default DialIn Access Number"} | Set-CsDialInConferencingAccessNumber -DisplayName "Litwareinc Conferencing"

示例 4 所示的命令更改了指定的电话拨入式会议接入号码的 Active Directory 显示名称。为执行此操作，该命令首先使用 Get-CsDialInConferencingAccessNumber 和 Filter 参数返回 DisplayName 属性等于“Default DialIn Access Number”的电话拨入式接入号码。然后，将此接入号码通过管道传递给 Set-CsDialInConferencingAccessNumber cmdlet，后者将显示名称更改为 Litwareinc Conferencing。

-------------------------- 示例 5 ------------------------

Get-CsDialInConferencingAccessNumber -Filter {LineUri -eq "TEL:+14255558715"} | Set-CsDialInConferencingAccessNumber -DisplayNumber "1-425-555-1298" -LineUri "tel:+14255551298"

示例 5 中同时修改了指定电话拨入式会议接入号码的显示号码和线路统一资源标识符 (URI)。为检索要修改的号码，该命令首先使用 Get-CsDialInConferencingAccessNumber 和 Filter 参数；伴随的筛选器值将返回的数据限制为 LineUri 属性等于 TEL:+14255558715 的访问号码。然后，将该访问号码通过管道传递到 Set-CsDialInConferencingAccessNumber，后者会同时修改该号码的 DisplayNumber 和 LineUri 属性。

-------------------------- 示例 6 ------------------------

Get-CsDialInConferencingAccessNumber | Where-Object {$_.PrimaryLanguage -ne "en-US"} | Set-CsDialInConferencingAccessNumber -SecondaryLanguages "fr-FR","it-IT"

上述命令为所有不使用美国英语作为主要语言的电话拨入式会议接入号码分配一对辅助语言。为执行此操作，该命令首先调用 Get-CsDialInConferencingAccessNumber，以返回所有配置为在组织中使用的电话拨入式会议接入号码的集合。然后，将该集合通过管道传递给 Where-Object cmdlet，后者仅选取 PrimaryLanguage 属性不等于美国英语 (en-US) 的那些号码。接下来，将筛选出的集合通过管道传递给 Set-CsDialInConferencingAccessNumber，后者使用 -SecondaryLanguages 参数为集合中的每个号码指定法国法语 (fr-FR) 和意大利语 (it-IT) 这两种辅助语言。

-------------------------- 示例 7 --------------------------

Get-CsDialInConferencingAccessNumber -Identity ""sip:RedmondDialIn@litwareinc.com"" -Priority 0 -ReorderedRegion Redmond

示例 7 中显示的命令将电话拨入式会议访问号码“sip:RedmondDialIn@litwareinc.com”指定为 Redmond 区域中优先级最高的号码，这会使该号码列为会议邀请和电话拨入式会议网页中的首个号码。要设置优先级，必须包含 Priority 参数并将参数值设置为 0（最高优先级的访问号码的 Priority 值为 0，次优先级的访问号码的 Priority 值为 1，依此类推）。此外，还应包含 ReorderedRegion 参数以指示将在 Redmond 区域内更改访问号码优先级。