Remove-CsCommonAreaPhone
上次修改主題的時間: 2012-03-27
使用 Microsoft Lync Server 2010,從受管理的電話集合中移除現有的公用區電話。公用區電話是位於建築物大廳、員工休息室內的電話,或其他由許多不同人使用的區域內的電話,用途也各異。
語法
Remove-CsCommonAreaPhone [-Identity] <UserIdParameter> [-Verbose] [-Debug] [-ErrorAction <ActionPreference>] [-WarningAction <ActionPreference>] [-ErrorVariable <String>] [-WarningVariable <String>] [-OutVariable <String>] [-OutBuffer <Int32>] [-WhatIf] [-Confirm]
詳細描述
公用區電話是未與個別使用者相關聯的 IP 電話。公用區電話不是位於某個人的辦公室中,通常是位於建築物大廳、餐廳、員工休息室、會議室以及其他一群人可能聚集的地點。這對系統管理員而言是一個管理上的挑戰;這是因為在 Lync Server 2010 中使用的電話通常是靠各種語音原則和撥號對應表在維護,而原則和對應表是指派給個別使用者。公用區電話不會被指派個別使用者。
解決此難題的方法是,針對所有的公用區電話建立 Active Directory 連絡人物件 (使用 New-CsCommonAreaPhone 指令程式建立這些連絡人物件)。就像使用者帳戶一樣,可以指派原則和語音對應表給這些連絡人物件。這樣一來,您就能夠對公用區電話保持控制,即使這些電話與個別使用者無關聯。例如,如果不要讓人從公用區電話轉接或保留通話,唯一要做的就是建立禁止通話轉接和保留通話的語音原則,然後將原則指派給公用區電話。(或者,更正確的說法是指派給代表公用區電話的連絡人物件)。例如,這個命令會指派語音原則 CommonAreaPhoneVoicePolicy 給您所有的公用區電話:
Get-CsCommonAreaPhone | Grant-CsVoicePolicy –PolicyName "CommonAreaPhoneVoicePolicy"
有時,您可能需要刪除與公用區電話相關聯的連絡人物件。例如,如果您移除了員工休息室的電話,就不再需要與該電話相關聯的連絡人物件。Remove-CsCommonAreaPhone 指令程式為您提供一個刪除公用區電話的方式。當您執行此指令程式時,將會從 Get-CsCommonAreaPhone 傳回的公用區電話清單中刪除該電話。此外,也會從 Active Directory 網域服務 (AD DS) 中刪除與該電話相關聯的連絡人物件。
誰可以執行此 Cmdlet:下列群組的成員預設會獲授權可以在本機上執行 Remove-CsCommonAreaPhone Cmdlet:RTCUniversalUserAdmins。可以使用 Grant-CsOUPermission 指令程式,為特定站台或特定 Active Directory 組織單位 (OU) 指派執行此指令程式的權限。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色),請在 Windows PowerShell 提示字元中執行下列命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsCommonAreaPhone"}
參數
參數 | 必要 | 類型 | 描述 |
---|---|---|---|
Identity |
必要 |
User ID 參數 |
公用區電話的唯一識別碼。識別公用區電話要使用相關聯連絡人物件的 Active Directory 辨別名稱。根據預設,公用區電話會使用全域唯一識別碼 (GUID) 作為其一般名稱,這表示這類電話的 Identity 通常會如下所示:CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com。因此,您可能會發現使用 Get-CsCommonAreaPhone 指令程式,然後將傳回的物件傳送到 Remove-CsCommonAreaPhone,能夠更輕易地擷取公用區電話。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果,但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.ADConnect.Schema.OCSADCommonAreaPhoneContact 物件。Remove-CsCommonAreaPhone 會接受公用區電話物件的管線執行個體。
傳回類型
Remove-CsCommonAreaPhone 會刪除 Microsoft.Rtc.Management.ADConnect.Schema.OCSADCommonAreaPhoneContact 物件的現有執行個體。
範例
-------------------------- 範例 1 ------------------------
Get-CsCommonAreaPhone -Filter {DisplayName -eq "Building 14 Lobby"} | Remove-CsCommonAreaPhone
範例 1 所示的命令會刪除顯示名稱為 "Building 14 Lobby" 的公用區電話。為達成此目的,命令會先呼叫 Get-CsCommonAreaPhone 搭配 Filter 參數和篩選值 "{DisplayName -eq "Building 14 Lobby"}"。然後將傳回的物件傳送到 Remove-CsCommonAreaPhone 指令程式,並由該指令程式加以刪除。
-------------------------- 範例 2 ------------------------
Get-CsCommonAreaPhone -Filter {DialPlan -eq $Null} | Remove-CsCommonAreaPhone
在範例 2 中,命令會刪除已指派撥號對應表的所有公用區電話。執行此工作的作法是先使用 Get-CsCommonAreaPhone 搭配 Filter 參數來傳回指定的項目;篩選值 {DialPlan -eq $Null} 會將傳回的資料限制為尚未指派撥號對應表的公用區電話。然後將篩選過的集合傳送到 Remove-CsCommonAreaPhone,這會刪除集合中的每個電話。
-------------------------- 範例 3 ------------------------
Get-CsCommonAreaPhone -OU "ou=Redmond,dc=litwareinc,dc=com" | Remove-CsCommonAreaPhone
範例 3 會刪除其連絡人物件位於 Active Directory 之 Redmond OU 中的所有公用區電話。為了執行此作業,會先呼叫 Get-CsCommonAreaPhone,以傳回 Redmond OU 中具備連絡人物件的所有公用區電話;OU 參數和參數值 "ou=Redmond,dc=litwareinc,dc=com" 會用來將傳回的資料限制為指定的組織單位。接著將傳回的集合傳送到 Remove-CsCommonAreaPhone,這會刪除集合中的各一個電話。