Get-CsUserAcp
上次修改主題的時間： 2012-03-23
傳回指派給使用者或使用者群組之音訊會議提供者的相關資訊。
語法
Get-CsUserAcp [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-Filter <String>] [-LdapFilter <String>] [-ResultSize <Unlimited>]
詳細描述
音訊會議提供者是提供組織會議服務的第三方公司。總而言之，音訊會議提供者提供處於異地之使用者在未連接至公司網路或網際網路，可參與會議之語音部分的方法。音訊會議提供者通常會提供高階服務，例如現場翻譯、記錄及現場個別會議總機服務。
Microsoft Lync Server 2010 不允許與音訊會議提供者完全整合。CsUserAcp 指令程式讓系統管理員可設定電話號碼和密碼，以及設定在使用者排程會議時隨時可用於音訊會議提供者整合的其他資訊。但是，因為這些指令程式並非設計來供 Lync Server 的內部部署版本使用 (他們的主要目的是和 Microsoft Lync Online 2010 搭配使用)，所以，除了指派內容值之外，不會提供任何其他音訊會議提供者整合。
Get-CsUserAcp 指令程式可讓您傳回指派給使用者或使用者群組之音訊會議提供者的相關資訊。若要傳回單一使用者之音訊會議提供者資訊，只要加上 Identity 參數，後面接著要傳回其資訊之使用者的 Identity 即可。若要傳回多位使用者的資訊，您可使用 LdapFilter 或 Filter 參數。LdapFilter 參數可讓您使用一般的 Active Directory 屬性，例如當指定使用者帳戶資訊時的 Department 或 Title；例如，參數值 "Title=Accountant" 會將傳回的資訊限制為其工作職稱為 Accountant 的使用者。Filter 參數可讓您使用 Microsoft Lync Server 2010 特定的屬性 (例如，VoicePolicy 或 EnterpriseVoiceEnabled) 來篩選傳回的資料。例如，篩選值 {EnterpriseVoiceEnabled –eq $True} 會將 Get-CsUserAcp 傳回的使用者帳戶限制為已啟用 Enterprise Voice 的使用者。
或者，您可呼叫 Get-CsUserAcp 且不搭配任何參數，以傳回所有使用者的音訊會議提供者資訊。請注意，Get-CsUserAcp 會傳回您所有使用者的音訊會議提供者資訊，包括尚未啟用 Lync Server 的使用者。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsUserAcp Cmdlet：RTCUniversalUserAdmins、RTCUniversalReadOnlyAdmins。若要傳回指派給該指令程式的所有角色型存取控制 (RBAC) 角色清單 (包括您自己建立的任何自訂 RBAC 角色)，請在 Windows PowerShell 提示中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsUserAcp"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
使用者識別 |
表示要擷取的使用者帳戶之 Identity。您可以使用下列四種格式的其中一種來指定使用者識別：1) 使用者的 SIP 位址；2) 使用者的使用者主體名稱 (UPN)；3) 使用者的網域名稱和登入名稱，格式為 domain\logon (例如 litwareinc\kenmyer)；4) 使用者的 Active Directory 網域服務 (AD DS) 顯示名稱 (如 Ken Myer)。您也可以使用使用者的 Active Directory 辨別名稱來參考使用者帳戶。 使用「顯示名稱」作為使用者 Identity 時，您可以使用星號 (*) 萬用字元。例如，Identity "* Smith" 會傳回所有顯示名稱是以字串 " Smith" 結束的使用者。 |
Credential |
選用 |
PS 認證物件 |
可讓您以替代認證來執行 Get-CsUserAcp 指令程式。如果您用來登入 Windows 的帳戶不具有使用連絡人物件所需的必要權限，可能就需要這一項。 若要使用 Credential 參數，您必須先使用 Get-Credential 指令程式建立 PSCredential 物件。如需詳細資料，請參閱 Get-Credential 指令程式說明主題。 |
Filter |
選用 |
字串 |
可讓您篩選 Lync Server 特定屬性來限制傳回的資料。例如，您可以將傳回的資料限制於已指派或未指派特定語音原則的使用者。 Filter 參數使用的 Windows PowerShell 篩選語法與 Where-Object 指令程式相同。例如，只傳回啟用 Enterprise Voice 之使用者的篩選看起來像這樣，EnterpriseVoiceEnabled 表示 Active Directory 網域服務 (AD DS) 屬性、-eq 表示比較運算子 (等於)，而 $True (內建 Windows PowerShell 變數) 表示篩選值： {EnterpriseVoiceEnabled -eq $True} |
LdapFilter |
選用 |
字串 |
可讓您篩選一般 Active Directory 屬性 (也就是非 Lync Server 專屬的屬性)，以限制傳回的資料。例如，您可以將傳回的資料限制於在特定部門工作的使用者，或具有指定主管或工作職稱的使用者。 在建立篩選時，LdapFilter 參數會使用 LDAP 查詢語言。例如，只傳回在 Redmond 市工作之使用者的篩選器如下所示："l=Redmond"，其中 "l" (小寫的 L) 代表 Active Directory 屬性 (locality)；"=" 是比較運算子 (等於)；"Redmond" 是篩選值。 |
ResultSize |
選用 |
整數 |
可讓您限制命令傳回的記錄數。例如，若要傳回七個使用者 (不考慮樹系中有多少使用者)，請加入 ResultSize 參數並將參數值設為 7。請注意，無法保證傳回哪 7 個使用者。如果您將 ResultSize 設為 7，但樹系中只有三個使用者，則命令會傳回這三個使用者，然後完成執行而不會出現錯誤。 結果大小可以設為 0 和 2147483647 (含) 之間的任何數字。如果設為 0，命令會執行，但不會傳回資料。 |
輸入類型
字串。Get-CsUserAcp 接受代表已為 Lync Server 2010 啟用之使用者帳戶 Identity 的管線傳送字串值。
傳回類型
Get-CsUserAcp 會傳回 Microsoft.Rtc.Management.ADConnect.Schema.ADUserAcp 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Get-CsUserAcp
範例 1 所示的命令會為您組織中的所有使用者傳回音訊會議提供者的資訊。
-------------------------- 範例 2 ------------------------
Get-CsUserAcp -Identity "Ken Myer"
上述命令會傳回單一使用者的音訊會議提供者資訊：含有 Identity Ken Myer 的使用者。在此案例中，使用使用者的 Active Directory 顯示名稱來指定識別身分。
-------------------------- 範例 3 ------------------------
Get-CsUserAcp -Filter {AcpInfo -ne $Null}
範例 3 會傳回已至少指派一位音訊會議提供者之所有使用者的資訊。為達成此目的，會加上 Filter 參數搭配篩選值 AcpInfo –ne $Null；此篩選值將傳回的資料限制為 AcpInfo 屬性值不等於 Null 值的使用者。若要傳回尚未指派音訊會議提供者之使用者的相關資訊，請使用這個篩選值：
{AcpInfo –eq $Null}
-------------------------- 範例 4 ------------------------
Get-CsUserAcp | Where-Object {$_.AcpInfo -match "Fabrikam ACP"
上述命令會傳回任何尚未指派音訊會議提供者 Fabrikam ACP 之使用者的音訊會議提供者相關資訊。為了執行此作業，命令會先使用 Get-CsUserAcp 且不搭配任何參數，以傳回您組織中的所有使用者的音訊會議提供者資訊。接著將此資訊傳送給 Where-Object 指令程式，它只會挑選出 AcpInfo 屬性包含 (-match) 字串值 "Fabrikam ACP" 的任何使用者。
-------------------------- 範例 5 ------------------------
Get-CsUserAcp -Identity "Ken Myer" | Select-Object -ExpandProperty AcpInfo
在範例 5 中，會顯示指派給使用者 Ken Myer 之音訊會議提供者的詳細資訊。為達成此目的，先呼叫 Get-CsUserAcp 以傳回 Ken Myer 的音訊會議提供者的資訊。然後將此資料傳送至 Select-Object 指令程式，以使用 ExpandProperty 參數來「擴充」AcpInfo 屬性值。擴充屬性值時，表示所有儲存於該值的資訊會以易於讀取的方式顯示。