Get-CsConferenceDirectory
上次修改主題的時間: 2012-03-23
傳回關於已設定為在組織中使用之會議目錄的資訊。會議目錄可用來協助電話撥入式會議使用者尋找會議資訊。
語法
Get-CsConferenceDirectory [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsConferenceDirectory [-Filter <String>] [-LocalStore <SwitchParameter>]
詳細描述
建立電話撥入式會議統一資源識別項 (URI) 時,會指派唯一 SIP 位址給這些 URI。不過,無法辨識 SIP 的裝置很難轉譯 SIP 位址;例如,公用交換電話網路 (PSTN) 電話無法轉譯 SIP 位址。有鑑於此,Microsoft Lync Server 2010 便會使用會議目錄來作為協助這些裝置尋找、連接及撥入會議的方法。完成此作業的方法是,建立與每個撥入式會議 URI 相關聯的 SIP 會議目錄,並以非 SIP URI 的整數值來識別。PSTN 電話和其他裝置在連線到會議時可以使用這些號碼 (而不是 SIP URI);使用者連線到電話撥入式會議時所輸入的 PSTN 會議識別中包含目錄號碼。
Get-CsConferenceDirectory 指令程式可讓您傳回設定用於組織之所有會議目錄的相關資訊。
誰可以執行此 Cmdlet:下列群組的成員預設會獲授權可以在本機上執行 Get-CsConferenceDirectory Cmdlet:RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色),請在 Windows PowerShell 提示字元中執行下列命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsConferenceDirectory"}
參數
參數 | 必要 | 類型 | 說明 |
---|---|---|---|
Identity |
選用 |
Xds 識別碼 |
要傳回之會議目錄的數值識別碼 (例如 7)。如果省略此參數,則 Get-CsConferenceDirectory 會傳回用於組織之所有會議目錄的相關資訊。 |
Filter |
選用 |
字串 |
可讓您使用萬用字元來指定要擷取之會議目錄的 Identity。由於目錄 Identity 是數值,因此此參數可能是最小的值。不過,此語法將傳回 Identity 開頭為數字 3: -Filter "3*" 的所有會議目錄。 |
LocalStore |
選用 |
切換參數 |
從中央管理存放區的本機複本擷取會議目錄資料,而非從中央管理存放區本身擷取。 |
輸入類型
無。Get-CsConferenceDirectory 不接受管線傳送的輸入。
傳回類型
Get-CsConferenceDirectory 會傳回 Microsoft.Rtc.Management.WritableConfig.Settings.PstnConf.ConferenceDirectories 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Get-CsConferenceDirectory
範例 1 所示的命令會傳回設定為在組織中使用之所有會議目錄的相關資訊。
-------------------------- 範例 2 ------------------------
Get-CsConferenceDirectory -Identity 2
範例 2 會傳回 Identity 為 2 的會議目錄相關資訊。由於 Identity 必須是唯一的,因此此命令絕不會傳回一個以上的會議目錄。
-------------------------- 範例 3 ------------------------
Get-CsConferenceDirectory | Where-Object {$_.ServiceID -match "UserServer:atl-cs-001.litwareinc.com"}
以上的命令會傳回存放於 UserServer:atl-cs-001.litwareinc.com 服務上的所有會議目錄。若要這樣做,此命令會先呼叫未含任何參數的 Get-CsConferenceDirectory,以傳回組織中找到之所有會議目錄的集合。接著,此集合會傳送至 Where-Object 指令程式,此指令程式只會選取 ServiceID 符合字串值 "UserServer:atl-cs-001.litwareinc.com" 的目錄。