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>]]
詳細描述
電話撥入式會議讓使用者可以使用任何一種電話 (例如，標準的「地面通訊」電話、行動電話或 Voice over Internet Protocol (VoIP) 電話) 加入會議的音訊部分。即使使用者沒有電腦或網際網路連線，都可讓他們參與會議。撥入使用者可用完整的音訊功能：他們可以與其他參與者講話，也可以聽到其他人所說的每句話；他們只是看不到共用的投影片、視訊播放或其他視覺元素。
若要為使用者提供電話撥入式會議的功能，您必須建立電話撥入式會議存取號碼：電話號碼使用者可以利用撥打電話的方式連線到會議。電話撥入式會議存取號碼是以 New-CsDialInConferencingAccessNumber 指令程式建立。當您建立新的電話撥入式會議存取號碼時，實際上是在 Active Directory 網域服務 (AD DS) 中建立新的連絡人物件。此連絡人物件用來代表存取號碼及其所有內容。
電話撥入式會議號碼建立完成之後，您可以使用 Set-CsDialInConferencingAccessNumber 指令程式修改該號碼的屬性。例如，您可以變更電話號碼 (LineUri) 本身之類的設定；或是表示該號碼之連絡人物件的顯示名稱。此外，Set-CsDialInConferencingAccessNumber 可讓您修改號碼的範圍；例如，您可以使用這個指令程式取得已經指派到通用範圍的號碼並重新指派給站台範圍。
誰可以執行此 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"。 存取號碼最多可以與四個次要語言相關聯。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.Xds.AccessNumber 物件。Set-CsDialInConferencingAccessNumber 接受管線傳送的存取號碼物件輸入。
傳回類型
Set-CsDialInConferencingAccessNumber 不會傳回值或物件。但是指令程式會設定 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。若要這樣做，會呼叫 Region 參數，然後是兩個地區 (以逗號分隔的兩個字串值)。請注意，除非已經在撥號對應表中定義 Redmond 和 Seattle 地區，否則這個命令將會失敗。
-------------------------- 範例 3 ------------------------
Get-CsDialInConferencingAccessNumber | Where-Object {$_.PrimaryLanguage -eq "fr-FR"}| Set-CsDialInConferencingAccessNumber -SecondaryLanguages "fr-CA"
在以上的範例中，主要語言為法文的所有電話撥入式會議存取號碼都會經過修改，以使用加拿大法文作為次要語言。若要執行這個工作，會先呼叫 Get-CsDialInConferencingAccessNumber 以傳回設定用於組織之所有電話撥入式存取號碼的集合。接著，該集合會傳送到 Where-Object 指令程式，以挑出 PrimaryLanguage 屬性等於 French ("fr-FR") 的存取號碼。然後，這個篩選過的集合會傳送到 Set-CsDialInConferencingAccessNumber，這會將 SecondaryLanguages 屬性的值設為 French Canadian ("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 指令程式，將顯示名稱變更為 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 指令程式，這樣只會選取 PrimaryLanguage 屬性不等於 US English (en-US) 的號碼。然後，篩選過的集合會傳送到 Set-CsDialInConferencingAccessNumber，以使用 -SecondaryLanguages 參數為集合中的每個號碼指派次要語言為 French (fr-FR) 和 Italian (it-IT)。
-------------------------- 範例 7 ------------------------
Get-CsDialInConferencingAccessNumber -Identity ""sip:RedmondDialIn@litwareinc.com"" -Priority 0 -ReorderedRegion Redmond
範例 7 所示的命令會將 Rdemond 地區的最高優先順序指派給電話撥入式會議存取號碼 "sip:RedmondDialIn@litwareinc.com"；因此，在會議邀請中和電話撥入式會議網頁上，會最先列出此號碼。為了設定優先順序，會加上 Priority 參數搭配參數值 0 (最高優先順序存取號碼的 Priority 值為 0，次高優先順序號碼的 Priority 值為 1，依此類推)。此外，也加上 ReorderedRegion 參數，以表示要在 Redmond 區域內變更存取號碼優先順序。