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