Get-CsExUmContact
上次修改主題的時間： 2012-03-23
擷取一或多個主控的 Exchange Unified Messaging (UM) 連絡人物件。
語法
Get-CsExUmContact [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-LdapFilter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>]
詳細描述
Microsoft Lync Server 2010 搭配 Exchange UM 一起提供多項語音相關功能，包括「自動語音應答」和「訂戶存取」。以主控服務 (非內部部署) 形式提供 Exchange UM 時，必須使用 Windows PowerShell 建立連絡人物件以套用「自動語音應答」和「訂戶存取」功能。此指令程式會擷取其中一或多個連絡人。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsExUmContact Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins、RTCUniversalReadOnlyAdmins。若要傳回指派給該指令程式的所有角色型存取控制 (RBAC) 角色清單 (包括您自己建立的任何自訂 RBAC 角色)，請在 Windows PowerShell 提示中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsExUmContact"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
選用 |
使用者 ID 參數 |
您要擷取之連絡人物件的唯一識別碼。可以使用下列四種格式的其中一種來指定連絡人識別身分：1) 連絡人的 SIP 位址；2) 連絡人的使用者主體名稱 (UPN)；3) 連絡人的網域名稱和登入名稱，格式為 domain\logon (例如，litwareinc\exum1)；以及 4) 連絡人的 Active Directory 顯示名稱 (例如，Team Auto Attendant)。 完整資料類型：Microsoft.Rtc.Management.AD.UserIdParameter |
Filter |
選用 |
字串 |
可讓您篩選 Lync Server 2010 特定屬性來限制傳回的資料。例如，您可以將傳回的資料限制為線路 URI 開頭為 "tel:555" 的連絡人。 Filter 參數會使用 Where-Object 指令程式所使用之 Windows PowerShell 篩選語法的子集。例如，只傳回已啟用 Enterprise Voice 之連絡人的篩選看起來如下：{EnterpriseVoiceEnabled -eq $True}，其中 EnterpriseVoiceEnabled 代表 Active Directory 屬性；-eq 代表比較運算子 (等於)；$True (內建的 Windows PowerShell 變數) 代表篩選值。 |
LdapFilter |
選用 |
字串 |
可讓您篩選「一般」Active Directory 屬性 (也就是非 Lync Server 專屬的屬性)，以限制傳回的資料。 在建立篩選時，LdapFilter 參數會使用 LDAP 查詢語言。 |
Credential |
選用 |
PS 認證 |
可讓您以替代認證來執行指令程式；如果您用來登入 Windows 的帳戶不具有使用連絡人物件所需的權限，可能就需要這一項。 若要使用 Credential 參數，您必須先呼叫 Get-Credential 指令程式建立 PSCredential 物件。 |
DomainController |
選用 |
Fqdn |
可讓您連線至指定的網域控制站，以擷取連絡人資訊。若要連線至特定的網域控制站，請加入 DomainController 參數，後面加上電腦名稱 (例如，atl-mcs-001) 或其完整網域名稱 (例如，atl-mcs-001.litwareinc.com)。 完整資料類型：Microsoft.Rtc.Management.Deploy.Fqdn |
OU |
選用 |
組織單位 Id 參數 |
可讓您將擷取的資料限制在特定 Active Directory 組織單位 (OU)。請注意，這會從指定的 OU 及任何子 OU 傳回資料。 指定 OU 時，請使用該容器的辨別名稱；例如，OU=ExUmContacts,dc=litwareinc,dc=com。 |
ResultSize |
選用 |
整數 |
可讓您限制命令傳回的記錄數。例如，若只要傳回七個連絡人 (不考慮樹系中有多少連絡人)，只需加入 ResultSize 參數並將參數值設為 7。請注意，無法保證傳回哪七個連絡人。如果您將 ResultSize 設為 7，但樹系中只有三個連絡人，則命令會傳回這三個連絡人，然後完成執行而不會出現錯誤。 結果大小可以設為 0 和 2147483647 (含) 之間的任何數字。如果設為 0，命令會執行，但不會傳回資料。 完整資料類型：Microsoft.Rtc.Management.ADConnect.Core.Unlimited |
輸入類型
字串。接受管線傳送的字串值，代表 Exchange UM 連絡人物件的 Identity。
傳回類型
傳回 Microsoft.Rtc.Management.ADConnect.Schema.OCSADExUmContact 類型的物件。
範例
-------------------------- 範例 1 --------------------------
Get-CsExUmContact
此範例會擷取 Lync Server 2010 部署內定義的所有 Exchange UM 連絡人。
-------------------------- 範例 2 --------------------------
Get-CsExUmContact -Identity sip:exum1@fabrikam.com
此範例會擷取 SIP 位址為 sip:exum1@fabrikam.com 的 Exchange UM 連絡人
-------------------------- 範例 3 --------------------------
Get-CsExUmContact -Filter {Enabled -eq $False}
在此範例中，我們使用 Filter 參數來擷取未啟用 Lync Server 2010 的所有 Exchange UM 連絡人。我們的作法是篩選 Enabled 屬性，以查看此屬性的值是否等於 (-eq) False ($False)。此命令傳回的連絡人將沒有作用。
-------------------------- 範例 4 --------------------------
Get-CsExUmContact -Filter {LineURI -like "tel:555*"}
此命令會篩選 LineURI 屬性以擷取 LineURI 開頭為 555 的所有 Exchange UM 連絡人。換言之，它會擷取電話號碼開頭為 555 的所有連絡人。
-------------------------- 範例 5 --------------------------
Get-CsExUmContact -OU "OU=ExUmContacts,DC=Vdomain,DC=com"
此範例中的命令使用 OU 參數來擷取 Active Directory OU OU=ExUmContacts,DC=Vdomain,DC=com 中的所有 Exchange UM 連絡人。