Get-CsAdContact
上次修改主題的時間： 2012-03-23
在多樹系的拓撲中，從您的主樹系以外的樹系傳回有關使用者帳戶的資訊；有些使用者已透過 Microsoft Forefront Identity Manager 2010 (或舊版產品) 複寫為連絡人物件。Get-CsAdContact 會傳回所有已設定 msRTCSIP-OriginatorSid 屬性值的使用者。
語法
Get-CsAdContact [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-LDAPFilter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>]
詳細描述
在多樹系拓撲中，來自其他樹系的使用者是以連絡人表示。這些連絡人和 Active Directory 的連絡人不一樣；如果您使用 [Active Directory 使用者和電腦] 建立新的連絡人，Get-CsAdContact 指令程式不會傳回此連絡人。而是 Get-CsAdContact 只會傳回來自您主樹系以外的樹系之使用者的相關資訊。如果您沒有多樹系拓撲，則不必呼叫 Get-CsAdContact
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsAdContact Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins、RTCUniversalReadOnlyAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsAdContact"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
UserId 參數 |
表示要傳回之連絡人的 Identity。可以使用下列三種格式中的其中一種來指定連絡人 Identity：1) 連絡人的 SIP 位址；2) 連絡人的 Active Directory 辨別名稱；以及 3) 連絡人的 Active Directory 顯示名稱 (例如 Ken Myer)。 使用「顯示名稱」作為連絡人 Identity 時，您可以使用星號 (*) 萬用字元。例如，Identity "* Smith" 會傳回顯示名稱以字串 "Smith" 結束的所有連絡人。 |
Credential |
選用 |
PSCredential 物件 |
可讓您以替代認證來執行 Get-CsAdContact 指令程式；如果您用來登入 Windows 的帳戶不具有使用連絡人物件所需的權限，可能就需要這一項。 若要使用 Credential 參數，您必須先使用 Get-Credential 指令程式建立 PSCredential 物件。如需詳細資料，請參閱 Get-Credential [說明] 主題。 |
DomainController |
選用 |
字串 |
可讓您連線至指定的網域控制站，以擷取連絡人資訊。若要連線至特定的網域控制站，請加入 DomainController 參數，後面加上完整網域名稱 (如 atl-cs-001.litwareinc.com)。 |
Filter |
選用 |
字串 |
可讓您篩選 Microsoft Lync Server 2010 特定屬性來限制傳回的資料。 Filter 參數使用的 Windows PowerShell 篩選語法與 Where-Object 指令程式相同。例如，只會傳回 SIP 位址是以 "fabrikam.com" 結束之連絡人的篩選器看起來如下：{SipAddress -like "*@fabrikam.com"}，其中 SipAddress 代表 Active Directory 屬性、-like 代表比較運算子，而 "*@fabrikam.com" 代表篩選值。 |
LdapFilter |
選用 |
字串 |
可讓您篩選一般 Active Directory 屬性來限制傳回的資料。例如，您可以將傳回的資料限制於在特定部門工作的連絡人，或具有指定主管或工作職稱的連絡人。 在建立篩選時，LdapFilter 參數會使用 LDAP 查詢語言。例如，傳回電話號碼為 1-425-555-1298 之連絡人的篩選器看起來如下："telephoneNumber=1-425-555-1298"，其中 "telephoneNumber" 代表 Active Directory 屬性、"=" 代表比較運算子 (等於)，而 "1-425-555-1298" 代表篩選值。 |
OU |
選用 |
辨別名稱 |
可讓您限制從特定 Active Directory 組織單位 (OU) 或容器擷取的資訊。此參數會從指定的 OU 及其任何子 OU 傳回資料。例如，如果 Finance OU 有兩個子 OU：會從這三個 OU 傳回 AccountsPayable 和 AccountsReceivable 連絡人。 指定 OU 時，請使用該容器的辨別名稱；例如：OU=Finance,dc=litwareinc,dc=com。 |
ResultSize |
選用 |
整數 |
可讓您限制指令程式傳回的記錄數。例如，若要傳回 7 個連絡人 (不考慮樹系中的連絡人數目)，請加入 ResultSize 參數並將參數值設為 7。請注意，無法保證傳回哪 7 個使用者。 結果大小可以設為 0 和 2147483647 (含) 之間的任何數字。如果設為 0，命令會執行，但不會傳回資料。如果您將 ResultSize 設為 7，但樹系中只有三個連絡人，則命令會傳回這三個連絡人，然後完成執行而不會出現錯誤。 |
輸入類型
字串。Get-CsAdContact 接受代表使用者帳戶之 Identity 的管線傳送字串值。
傳回類型
Get-CsAdContact 會傳回 Microsoft.Rtc.Management.ADConnect.Schema.ADContact 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Get-CsAdContact
範例 1 所示的命令會傳回 Active Directory 網域服務 (AD DS) 中所有多樹系連絡人的集合。呼叫 Get-CsAdContact 而不使用任何其他參數，會傳回 Active Directory 所有連絡人的所有屬性值。
-------------------------- 範例 2 ------------------------
Get-CsAdContact | Select-Object DisplayName, SipAddress
範例 2 也會傳回 Active Directory 所有連絡人的集合。但是在這個例子中，該集合會傳送給 Select-Object 指令程式，由其指定會顯示在螢幕上的兩個屬性：DisplayName 和 SipAddress。
-------------------------- 範例 3 ------------------------
Get-CsAdContact -Identity "Ken Myer"
前面的命令會傳回單一 Active Directory 連絡人的資訊：含有 Identity 為 "Ken Myer" 的連絡人。
-------------------------- 範例 4 ------------------------
Get-CsAdContact -LdapFilter "Organization=Fabrikam"
在範例 4 中，命令會傳回所有為 Fabrikam 工作的 Active Directory 連絡人。為達成此目的，會呼叫 Get-CsAdContact 並搭配 LdapFilter 參數。在此範例中，會將傳回的資料限制為其 Organization 屬性已設定為 "Fabrikam" 的連絡人。
-------------------------- 範例 5 ------------------------
$x = Get-Credential -Credential "litwareinc\administrator"
Get-CsAdContact -Credential $x
範例 5 中的兩個命令示範 Credential 參數的使用，這個參數讓您可以用替代認證來執行 Get-CsAdContact。在第一個命令中，呼叫 Get-Credential 指令程式來建立 litwareinc\administrator 帳戶的 PSCredential 物件。此命令會顯示使用者 litwareinc\administrator 的 [認證要求] 對話方塊；在您提供此帳戶的密碼後，該憑證資訊將會儲存在變數 $x 中。在第二個命令中，會呼叫 Get-CsAdContact 搭配 Credential 參數。參數值 $x 表示 Get-CsAdContact 應在 litwareinc\administrator 帳戶下執行。