Remove-CsConferenceDirectory
上次修改主題的時間: 2012-03-25
移除現有的會議目錄。會議目錄可用來協助電話撥入式會議使用者尋找會議資訊。
語法
Remove-CsConferenceDirectory -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
在建立電話撥入式會議統一資源識別項 (URI) 時,系統會為這些 URI 指派唯一的 SIP 位址。然而,對於無法識別 SIP 的裝置來說,SIP 位址是難以轉譯的位址;例如,公用交換電話網路 (PSTN) 電話無法轉譯 SIP 位址。有鑑於此,Microsoft Lync Server 2010 便會使用會議目錄來作為協助這些裝置尋找、連接及撥入會議的方法。這項作業的操作方法為建立和每個撥入會議 URI 相關的 SIP 會議目錄,然後再利用整數值 (而非 SIP URI) 來加以識別。然後,當 PSTN 電話和其他裝置連線到會議時,可以使用這些號碼 (非 SIP URI);目錄號碼包含在使用者連線到撥入式會議時所輸入的 PSTN 會議識別中。
您可以使用 New-CsConferenceDirectory 指令程式來建立會議目錄。您偶爾可能需要刪除一或多個這類目錄。例如,可能需要淘汰主控這些目錄的集區。您可以使用 Remove-CsConferenceDirectory 指令程式來移除會議目錄。請注意,如果您必須將某個集區中的目錄移動到另一個集區,則只要呼叫 Move-CsConferenceDirectory 指令程式即可。
誰可以執行此 Cmdlet:下列群組的成員預設會獲授權可以在本機上執行 Remove-CsConferenceDirectory Cmdlet:RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色),請在 Windows PowerShell 提示字元中執行下列命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsConferenceDirectory"}
參數
參數 | 必要 | 類型 | 描述 |
---|---|---|---|
Identity |
必要 |
Xds 識別身份 |
要移除之會議目錄的數字身分識別。 |
Force |
選用 |
切換參數 |
使用後,即便是主控會議目錄的集區目前無法使用,也能移除目錄。根據預設,如果無法和對應的集區連絡,Remove-CsConferenceDirectory 將不會移除目錄。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果,但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.PstnConf.ConferenceDirectories 物件。Remove-CsConferenceDirectory 接受會議目錄物件管線傳送的輸入。
傳回類型
無。而是 Removes-CsConferenceDirectory 會刪除 Microsoft.Rtc.Management.WritableConfig.Settings.PstnConf.ConferenceDirectories 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Remove-CsConferenceDirectory -Identity 2
範例 1 所示的命令會刪除具有 Identity 2 的會議目錄。
-------------------------- 範例 2 ------------------------
Get-CsConferenceDirectory | Where-Object {$_.ServiceID -match "UserServer:atl-cs-001.litwareinc.com"} | Remove-CsConferenceDirectory
上述命令會刪除所有在 UserServer:atl-cs-001.litwareinc.com 服務上找到的會議目錄。為達成此目的,此命令會先呼叫不含任何參數的 Get-CsConferenceDirectory,傳回組織中目前正在使用的所有會議目錄集合。接著,系統會將這個集合傳送到 Where-Object 指令程式;該指令程式只會挑選主控於 UserServer:atl-cs-001.litwareinc.com 服務上的目錄。然後,系統會將篩選過的集合傳送給 Remove-CsConferenceDirectory 指令程式,由該指令程式執行刪除作業。