Remove-CsUserAcp
上次修改主題的時間： 2012-03-25
移除一或多個指派給使用者或使用者群組的音訊會議提供者。
語法
Remove-CsUserAcp -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-Name <String>] [-ParticipantPasscode <String>] [-PassThru <SwitchParameter>] [-TollNumber <String>] [-WhatIf [<SwitchParameter>]]
詳細描述
音訊會議提供者是提供組織會議服務的第三方公司。總而言之，音訊會議提供者提供處於異地之使用者在未連接至公司網路或網際網路，可參與會議之語音部分的方法。音訊會議提供者通常會提供高階服務，例如現場翻譯、記錄及現場個別會議總機服務。
Microsoft Lync Server 2010 不允許與音訊會議提供者完全整合。CsUserAcp 指令程式確實可讓系統管理員設定電話號碼和密碼，以及設定在使用者排程會議時隨時可用於音訊會議提供者整合的其他資訊。但是，因為這些指令程式並非設計來供 Lync Server 的內部部署版本使用 (他們的主要目的是和 Microsoft Lync Online 2010 搭配使用)，所以，除了指派內容值之外，不會提供任何其他音訊會議提供者整合。
任何指派給使用者的音訊會議提供者可使用 Remove-CsUserAcp 指令程式於稍後進行移除。呼叫 Remove-CsUserAcp 且不搭配任何參數 (非 Identity 參數，其指出要修改的使用者帳戶) 可移除指派給使用者的所有音訊會議提供者。或者，您可使用內含 Remove-CsUserAcp 的選用參數，從使用者帳戶移除選取的提供者。例如，這個命令找到 Ken Myer 使用者帳戶，並移除具有 Name 等於 “Fabrikam ACP” 的所有音訊會議提供者：
Remove-CsUserAcp –Identity "Ken Myer" –Name "Fabrikam ACP"
若要提供音訊會議提供者的較細部移除，只要包含其他參數即可。例如，這個命令會移除具有 Name 為 “Fabrikam ACP” 及 TollNumber 等於 "14255551298" 的任何音訊會議提供者，如下所示：
Remove-CsUserAcp –Identity "Ken Myer" –Name "Fabrikam ACP" –TollNumber "14255551298"
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Remove-CsUserAcp Cmdlet：RTCUniversalUserAdmins。若要傳回指派給該指令程式的所有角色型存取控制 (RBAC) 角色清單 (包括您自己建立的任何自訂 RBAC 角色)，請在 Windows PowerShell 提示中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsUserAcp"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
使用者識別 |
指出將要移除音訊會議提供者之使用者帳戶的 Identity。您可以使用下列四種格式的其中一種來指定使用者的 Identity：1) 使用者的 SIP 位址；2) 使用者的使用者主體名稱 (UPN)；3) 使用者的網域名稱和登入名稱，格式為 domain\logon (例如 litwareinc\kenmyer)；4) 使用者的 Active Directory 網域服務 (AD DS) 顯示名稱 (如 Ken Myer)。您也可以使用使用者的 Active Directory 辨別名稱來參考使用者識別。 使用「顯示名稱」作為使用者識別時，您可以使用星號 (*) 萬用字元。例如，Identity "* Smith" 會傳回所有顯示名稱是以字串 " Smith" 結束的使用者。 |
Name |
選用 |
字串 |
音訊會議提供者的名稱。例如：-Name "Fabrikam Conference Services"。 |
ParticipantPassCode |
選用 |
字串 |
使用音訊會議提供者連接至會議時所需的密碼。例如：-PassCode "0712"。 |
TollNumber |
選用 |
字串 |
用於音訊會議的非免付費電話號碼。例如：-TollNumber "14255551298"。 |
PassThru |
選用 |
切換參數 |
可讓您透過管線傳遞使用者物件，表示擁有音訊會議提供者的使用者已遭移除。根據預設，Remove-CsUserAcp 指令程式不會透過管線傳遞任何物件。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
字串或 Microsoft.Rtc.Management.ADConnect.Schema.ADUser 物件。Remove-CsUserAcp 接受代表已為 Microsoft Lync Server 2010 啟用之使用者帳戶 Identity 的管線傳送字串值。該指令程式也接受管線傳送的 Active Directory 使用者物件執行個體。
傳回類型
無。
範例
-------------------------- 範例 1 ------------------------
Remove-CsUserAcp -Identity "Ken Myer"
範例 1 所示的命令會移除已指派給使用者 Ken Myer 的所有音訊會議提供者。
-------------------------- 範例 2 ------------------------
Get-CsUser | Remove-CsUserAcp
範例 2 會為您顯示如何移除已指派給已為 Lync Server 2010 啟用之所有使用者的所有音訊會議提供者。為達成此目的，命令會先使用 Get-CsUser，來擷取已啟用 Lync Server 之所有使用者的集合。然後將該集合傳送給 Remove-CsUserAcp 指令程式，這會移除已指派給集合中每個使用者的所有音訊會議提供者。
-------------------------- 範例 3 ------------------------
Remove-CsUserAcp -Identity "Ken Myer" -Name "Fabrikam ACP"
在範例 3 中，會從 Ken Myer 的使用者帳戶移除具有 Name 為 "Fabrikam ACP" 的所有音訊會議提供者。
-------------------------- 範例 4 ------------------------
Get-CsUserAcp | Where-Object {$_.AcpInfo -match "14255551298"} | Remove-CsUserAcp
上述命令會從已指派音訊會議提供者的所有使用者帳戶移除含有免付費電話號碼 "14255551298" 的音訊會議提供者。為了執行此作業，命令會先使用 Get-CsUserAcp，傳回指派給您所有使用者之所有音訊會議提供者的相關資訊。接著將此資訊傳送給 Where-Object 指令程式，它只會選取 AcpInfo 屬性包含 (-match) 電話號碼 "14255551298" 的那些帳戶。然後將此篩選過的集合傳送給 Remove-CsUserAcp 指令程式，這會從篩選過的集合中的每個帳戶移除對應的音訊會議提供者。