Move-CsCommonAreaPhone
上次修改主題的時間: 2012-03-23
將一或多個公用區電話移至新的登錄器集區。
語法
Move-CsCommonAreaPhone -Identity <UserIdParameter> -Target <Fqdn> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-PassThru <SwitchParameter>] [-ProxyPool <Fqdn>] [-WhatIf [<SwitchParameter>]]
詳細描述
公用區電話是未與個別使用者相關聯的 IP 電話。公用區電話不是位於某個人的辦公室中,通常是位於建築物大廳、餐廳、員工休息室、會議室以及其他一群人可能聚集的地點。這對系統管理員而言是一個管理上的挑戰;這是因為在 Lync Server 2010 中使用的電話通常是靠各種語音原則和撥號對應表在維護,而原則和對應表是指派給個別使用者。公用區電話不會被指派個別使用者。
解決此難題的方法是,針對所有的公用區電話建立 Active Directory 連絡人物件。(使用 New-CsCommonAreaPhone 指令程式建立這些連絡人物件)。就像使用者帳戶一樣,可以指派原則和語音對應表給這些連絡人物件。這樣一來,您就能夠對公用區電話保持控制,即使這些電話與個別使用者無關聯。例如,如果不要讓人從公用區電話轉接或保留通話,唯一要做的就是建立禁止通話轉接和保留通話的語音原則,然後將原則指派給公用區電話。(或者,更正確的說法是指派給代表公用區電話的連絡人物件)。
Move-CsCommonAreaPhone 指令程式讓您能夠將現有的公用區電話移至新的登錄器集區。
誰可以執行此 Cmdlet:下列群組的成員預設會獲授權可以在本機上執行 Move-CsCommonAreaPhone Cmdlet:RTCUniversalUserAdmins。可以使用 Grant-CsOUPermission 指令程式,為特定站台或特定 Active Directory 組織單位 (OU) 指派執行此指令程式的權限。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色),請在 Windows PowerShell 提示字元中執行下列命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Move-CsCommonAreaPhone"}
參數
參數 | 必要 | 類型 | 描述 |
---|---|---|---|
Identity |
必要 |
UserID |
公用區電話的唯一識別碼。識別公用區電話要使用相關聯連絡人物件的 Active Directory 辨別名稱。根據預設,公用區電話會使用全域唯一識別碼 (GUID) 作為其一般名稱,這表示這類電話的 Identity 通常會如下所示:CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com。 |
Target |
必要 |
FQDN |
應移動其公用區電話之登錄器集區的完整網域名稱 (FQDN);例如:atl-cs-001.litwareinc.com。除了登錄器集區外,Target 也可以是代管供應商的 FQDN。 |
DomainController |
選用 |
FQDN |
讓您連線至指定的網域控制站,以移動使公用區電話。若要連線至特定的網域控制站,請加入 DomainController 參數,後面加上電腦名稱 (例如,atl-cs-001) 或其 FQDN (例如,atl-cs-001.litwareinc.com)。 |
ProxyPool |
選用 |
完整的網域名稱 |
此參數只能用於 Microsoft Lync Online 2010。請勿用於 Lync Server 的內部部署實作。 |
Force |
選用 |
切換參數 |
如果存在,則會移動公用區電話,但刪除任何關聯的資料 (例如,已指派給裝置的原則)。如果不存在,則會連同任何關聯的資料一起移動電話。 |
PassThru |
選用 |
切換參數 |
讓您透過管線傳遞使用者物件,代表被移動的使用者帳戶。根據預設,Move-CsCommonAreaPhone 指令程式不會透過管線傳遞任何物件。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果,但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
字串。Move-CsCommonAreaPhone 接受代表公用區電話之 Identity 的管線傳送字串值。
傳回類型
Move-CsCommonAreaPhone 預設不會傳回任何物件或值。但是,如果您包含 PassThru 參數,指令程式會傳回 Microsoft.Rtc.Management.ADConnect.Schema.OCSADCommonAreaPhoneContact 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Move-CsCommonAreaPhone -Identity "CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com" -Target atl-cs-001.litwareinc.com
範例 1 所示的命令會將 Identity 為 CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com 的公用區電話移至登錄器集區 atl-cs-001.litwareinc.com。
-------------------------- 範例 2 ------------------------
Get-CsCommonAreaPhone | Where-Object {$_.DisplayName -eq "Building 31 Cafeteria"} | Move-CsCommonAreaPhone -Target atl-cs-001.litwareinc.com
在範例 2 中,會將 Active Directory 顯示名稱為 "Building 31 Cafeteria" 的公用區電話移至登錄器集區 atl-cs-001.litwareinc.com。為達成此目的,會先呼叫 Get-CsCommonAreaPhone 且不使用任何參數,以傳回所有目前在組織中使用之公用區電話的集合。然後此集合會傳送至 Where-Object 指令程式,其只會選出 DisplayName 屬性等於 "Building 31 Cafeteria" 的電話。該篩選過的集合接著會傳送到 Move-CsCommonAreaPhone,其會將集合中的每一個電話移至 atl-cs-001.litwareinc.com。
-------------------------- 範例 3 ------------------------
Get-CsCommonAreaPhone | Where-Object {$_.RegistrarPool -match "dublin-cs-001.litwareinc.com"} | Move-CsCommonAreaPhone -Target atl-cs-001.litwareinc.com
上述範例會將目前隸屬於登錄器集區 dublin-cs-001.litwareinc.com 的所有公用區電話移至登錄器集區 atl-cs-001.litwareinc.com。為了執行此作業,命令會先呼叫不含任何參數的 Get-CsCommonAreaPhone;如此會傳回設定為在組織中使用的所有公用區電話集合。然後此集合會傳送到 Where-Object 指令程式,其會挑選 RegistrarPool 等於 dublin-cs-001.litwareinc.com 的所有公用區電話。此集合接著會傳送到 Move-CsCommonAreaPhone,其會將集合中的每一個電話移至新的登錄器集區 atl-cs-001.litwareinc.com。
-------------------------- 範例 4 ------------------------
Get-CsCommonAreaPhone | Where-Object {$_.RegistrarPool -match "dublin-cs-001.litwareinc.com"} | Move-CsCommonAreaPhone -Target atl-cs-001.litwareinc.com -PassThru | Grant-CsVoicePolicy -PolicyName AtlantaVoicePolicy
範例 4 是範例 3 命令的變化;但在此案例中,不只會將公用區電話移至新的登錄器集區,還會指派新的個別使用者語音原則。為達成此目的,在呼叫 Move-CsCommonAreaPhone 時,會包含 PassThru 參數;如果要透過管線傳送公用區電話,則此為必要參數 (根據預設,Move-CsCommonAreaPhone 不會透過管線傳送物件)。移動電話之後,電話物件即會傳送到 Grant-CsVoicePolicy 指令程式,其會將語音原則 AtlantaVoicePolicy 指派給每個新移動的電話。