Get-CsDialInConferencingAccessNumber
上次修改主題的時間： 2012-03-23
傳回已設定要在組織內使用之所有電話撥入式會議存取號碼的相關資訊。電話撥入式會議提供方法，讓使用者可使用「一般」電話、行動電話或公用交換電話 (PSTN) 網路上的裝置，加入線上會議的音訊部分。
語法
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>]
詳細描述
電話撥入式會議讓使用者可以使用任何一種電話 (例如標準的「地面通訊」電話、行動電話或 Voice over Internet Protocol (VoIP) 電話) 加入線上會議的音訊部分。讓使用者即使沒有電腦或網際網路連線也可以參與會議。使用者可用完整的音訊功能：他們可以對其他參與者講話，聽到其他人所說的每句話。不過，還是看不到共用的投影片、視訊播放，或其他視覺元素。
若要為使用者提供電話撥入式會議的功能，您必須建立電話撥入式會議存取號碼：該使用者可撥入以連線至會議的電話號碼。電話撥入式會議存取號碼是以 New-CsDialInConferencingAccessNumber 指令程式建立。當您建立新的電話撥入式會議存取號碼時，實際上會在 Active Directory 網域服務 (AD DS) 中建立新的連絡人物件；此連絡人物件可用來代表存取號碼及其所有屬性。您可以使用 Get-CsDialInConferencingAccessNumber 指令程式來擷取連絡人號碼。
如果您已從 Microsoft Office Communications Server 2007 匯入電話撥入式會議存取號碼，系統會藉由執行 Get-CsDialInConferencingAccessNumber 且包含 Region 參數，也擷取這些號碼 (除非您使用 Region 參數，否則系統不會顯示匯入的號碼)。但是，請注意，會有一則警告訊息顯示在匯入號碼的統一資源識別項 (URI) 旁邊。這只是指令程式處理匯入的電話撥入式會議存取號碼的方式。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsDialInConferencingAccessNumber Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins、RTCUniversalReadOnlyAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsDialInConferencingAccessNumber"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
SIP 位址 |
要擷取之電話撥入式會議存取號碼的 SIP 位址 (也就是，代表該號碼的連絡人物件)。指定 Identity 時，必須加上 "sip:"指定 Identity 時的前置字元；例如：-Identity sip:RedmondDialIn@litwareinc.com。 如果未指定此參數，則 Get-CsDialInConferencingAccessNumber 將傳回已設定要在組織內使用的所有電話撥入式會議存取號碼。 |
Credential |
選用 |
PS 認證物件 |
可讓您以替代認證來執行 Get-CsDialInConferencingAccessNumber 指令程式；如果您用來登入 Windows 的帳戶不具有使用連絡人物件所需的權限，可能就需要這一項。 若要使用 Credential 參數，您必須先使用 Get-Credential 指令程式建立 PSCredential 物件。如需詳細資料，請參閱 Get-Credential [說明] 主題。 |
DomainController |
選用 |
字串 |
可讓您連線至指定的網域控制站，以擷取連絡人資訊。若要連線至特定的網域控制站，請加入 DomainController 參數，後面加上電腦名稱 (例如，atl-mcs-001) 或其完整網域名稱 (例如，atl-mcs-001.litwareinc.com)。 |
EmptyRegion |
選用 |
切換參數 |
傳回與區域相關聯的撥號對應表相關資訊，該區域與至少一組電話撥入式會議存取號碼無關聯。例如，假設 Bellevue 撥號對應表會與 Bellevue 地區產生關聯，但並未針對 Bellevue 地區設定任何存取號碼。因此 Bellevue 區域應被視為空白區域。 這個參數無法和任何其他參數一起使用。 |
Filter |
選用 |
字串 |
可讓您篩選 Microsoft Lync Server 2010 的特定屬性來限制傳回的資料。例如，您可以將傳回的資料限制為在其顯示名稱中含字串值 "Redmond" 的電話撥入式會議號碼，或者使用 1-800 首碼的免付費電話撥入式會議號碼。 Filter 參數使用的 Windows PowerShell 篩選語法與 Where-Object 指令程式相同。例如，只會傳回首碼為 1-800 之存取號碼的篩選看起來如下：{LineUri -like "tel:+1800*"}，其中 withLineUri 代表 Active Directory 屬性、-like 代表比較運算子，而 "tel:+1800*" 代表篩選值。 |
OU |
選用 |
字串 |
可讓您從特定 Active Directory 組織單位 (OU) 傳回存取號碼。這會包括來自指定 OU 及其任何子 OU 的資料。例如，如果 Finance OU 有兩個子 OU (即 AccountsPayable 和 AccountsReceivable)，則會從這三個 OU 中的每一個 OU 傳回存取號碼資訊。 指定 OU 時，請使用該容器的辨別名稱；例如：-OU "OU=Finance,dc=litwareinc,dc=com"。 |
Region |
選用 |
字串 |
傳回與指定撥號對應表地區相關聯的所有電話撥入式會議存取號碼。例如，若要傳回 Northwest 地區的所有撥入號碼，請使用下列語法：-Region Northwest。 您也可以藉由在參數值中包含範圍，傳回已被納入特定站台範圍 (或納入通用範圍) 的存取號碼。例如，若要傳回使用 Northwest 區域的存取號碼，且這些存取號碼已被納入 Redmond 站台的範圍，請使用此語法：-Region site:Redmond/Northwest。請注意，參考站台範圍時，您必須使用 SiteId 屬性。您可以使用 Get-CsSite 指令程式來擷取 SiteId 值。 若要傳回與撥號對應表不相關的存取號碼清單，請將 Region 參數值設定為 $Null:-Region $Null。 請注意，如果指定了此值，電話撥入式會議存取號碼僅會以其指派的優先順序傳回。優先順序與號碼出現在會議邀請及電話撥入式會議網頁上的順序相同。如需詳細資料，請參閱 Set-CsDialInConferencingAccessNumber 說明主題。 |
ResultSize |
選用 |
整數 |
可讓您限制命令傳回的記錄數。例如，若只要傳回七個存取號碼 (不考慮樹系中有多少存取號碼)，只需加入 ResultSize 參數並將參數值設為 7。請注意，無法保證傳回哪七個項目。如果您將 ResultSize 設為 7，但樹系中只有三個存取號碼，則命令會傳回這三個號碼，然後完成執行而不會出現錯誤。 結果大小可以設為 0 和 2147483647 (含) 之間的任何數字。如果設為 0，命令會執行，但不會傳回資料。 |
輸入類型
字串。Get-CsDialInConferencingAccessNumber 會接受代表存取號碼之 Identity 的字串值。
傳回類型
Get-CsDialInConferencingAccessNumber 會傳回 Microsoft.Rtc.Management.Xds.AccessNumber 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Get-CsDialInConferencingAccessNumber
範例 1 所示的命令會傳回已設定為在組織內使用的所有電話撥入式會議存取號碼集合。呼叫 Get-CsDialInConferencingAccessNumber 而不指定任何其他參數，將一律傳回所有可用的電話撥入式存取號碼集合。
-------------------------- 範例 2 ------------------------
Get-CsDialInConferencingAccessNumber -Identity sip:RedmondDialIn@litwareinc.com
在範例 2 中，會傳回 Identity 為 sip:RedmondDialIn@litwareinc.com 的電話撥入式會議存取號碼。由於識別身分必須是唯一的，因此這個命令絕對不會傳回一個以上的存取號碼。
-------------------------- 範例 3 ------------------------
Get-CsDialInConferencingAccessNumber -Region "Redmond"
範例 3 使用 Region 參數，來傳回與 Redmond 地區相關聯的所有電話撥入式會議存取號碼。為達成此目的，會呼叫 Get-CsDialInConferencingAccessNumber 搭配 Region 參數。指定 "Redmond" 做為參數值會導致 Get-CsDialInConferencingAccessNumber 傳回 "Redmond" 出現在相關聯地區清單中的所有號碼。例如，會傳回只將 Redmond 列為地區的存取號碼，如同會同時列出 Redmond 和 Portland 的存取號碼。
-------------------------- 範例 4 ------------------------
Get-CsDialInConferencingAccessNumber -Region $Null
上述命令會傳回與某個地區不相關 (也就是，Regions 屬性為空白) 的所有電話撥入式會議存取號碼。
-------------------------- 範例 5 ------------------------
Get-CsDialInConferencingAccessNumber -Region site:USA/Redmond
範例 5 所示的命令會傳回已被納入 USA 站台 (也就是 SiteId site:USA 的站台) 的所有電話撥入式會議存取號碼。
-------------------------- 範例 6 ------------------------
Get-CsDialInConferencingAccessNumber -Filter {DisplayName -like "*Seattle*"}
在範例 6 中，會使用 Filter 參數，以傳回在其 DisplayName 的某處包含字串值 "Seattle" 的所有電話撥入式會議存取號碼集合。篩選值 {DisplayName -like "*Seattle*"} 會將傳回的資料限制為 DisplayName 包含單字 "Seattle" (例如，Seattle Access Number；Dial-In Number for Seattle；Tacoma/Seattle Access Number 等) 的存取號碼。
-------------------------- 範例 7 ------------------------
Get-CsDialInConferencingAccessNumber -Filter {LineUri -like "tel:+1425*"}
範例 7 會傳回 Uri 行是以 +1425 開頭的所有電話撥入式會議存取號碼；這可有效傳回區碼為 425 的所有美國存取號碼。為達成此目的，會呼叫 Get-CsDialInConferencingAccessNumber 搭配 Filter 參數；篩選值 {LineUri -like "tel:+1425*"} 會將傳回的資料限制為以字串值 "tel:+1425" 開頭的 Uri 行。若要傳回區碼為 425 或區碼為 206 的所有電話號碼，請使用下列篩選值：
{LineUri -like "tel:+1425*" -or LineUri -like "tel:+1206*"}
-------------------------- 範例 8 ------------------------
Get-CsDialInConferencingAccessNumber | Where-Object {$_.PrimaryLanguage -eq "it-IT"}
上述範例會傳回主要語言已設定為 Italian 的所有電話撥入式會議存取號碼集合。為了執行此作業，會先呼叫 Get-CsDialInConferencingAccessNumber，以便傳回已設定為在組織內使用的所有存取號碼集合。然後將此集合傳送到 Where-Object 指令程式，它只會選取 PrimaryLanguage 屬性等於 Italian ("it-It") 的號碼。
-------------------------- 範例 9 ------------------------
Get-CsDialInConferencingAccessNumber | Where-Object {$_.SecondaryLanguages -contains "fr-FR"}
範例 9 所示的命令會傳回已將 French 列為其中一個次要語言的所有電話撥入式會議存取號碼。為了完成此工作，會先呼叫 Get-CsDialInConferencingAccessNumber 但不指定任何參數；這會傳回設定為在組織內使用之存取號碼的完整集合。然後將此集合傳送到 Where-Object 指令程式，這樣只會選取 SecondaryLanguages屬性包含 French (fr-FR) 清單的號碼。