Test-CsGroupExpansion
上次修改主題的時間： 2012-03-27
測試使用者擴充群組的能力。Microsoft Lync Server 2010 可讓使用者將 Active Directory 通訊群組設定為連絡人。當您「擴充」群組時，您會看到每個群組成員的名稱與目前狀態資訊。
語法
Test-CsGroupExpansion -TargetFqdn <String> -GroupEmailAddress <String> [-External <SwitchParameter>] [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-UserSipAddress <String>]
Test-CsGroupExpansion -GroupEmailAddress <String> -TargetUri <String> -UserSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-WebCredential <PSCredential>]
Test-CsGroupExpansion [-TargetFqdn <String>] -GroupEmailAddress <String> -UserCredential <PSCredential> -UserSipAddress <String> [-External <SwitchParameter>] [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
詳細描述
使用者有時需要定期與 Active Directory 通訊群組的所有成員進行通訊對使用者而言是極為平常的事情。例如，該群組可能包含某小組的所有成員，或指派給某特定專案的所有人員。有鑑於此，Lync Server 2010 可讓您將 Active Directory 通訊群組設定為連絡人。若您這麼做，只要處理給群組而非該群組每個個別成員的訊息，您便可在之後將相同的立即訊息傳送給所有的群組成員。
也有可能您需要與該群組某些個人進行通訊 (或檢查其目前狀態)。群組擴充可讓您快速輕鬆檢視所有群組成員及其目前狀態。此外，您也可以選取一或多個群組成員，然後將立即訊息傳送給這些成員，而非所有群組成員。
可使用 Set-CsWebServiceConfiguration 指令程式啟用或停用群組擴充。若啟用了群組擴充，您可決定是否藉由執行 Test-CsGroupExpansion 指令程式使該功能運作。使用此指令，您可以使用群組的電子郵件地址來指定 Active Directory 通訊群組。Test-CsGroupExpansion 接著會使用群組擴充來擷取群組成員資格，並將擷取的清單與您提供的群組電子郵件地址的成員資格進行比較。若兩份清單相符，則群組擴充運作正確。
請注意，您可以下列兩種不同的方式測試群組擴充：測試服務本身，或測試相關聯的 Web 服務。
誰可以執行這個指令程式：若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsGroupExpansion"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
GroupEmailAddress |
必要 |
字串 |
目標通訊群組成員的電子郵件地址。例如：-GroupEmailAddress "FinanceGroup@litwareinc.com"。 |
External |
選用 |
切換參數 |
可讓您確認外部使用者可使用群組擴充。 |
RegistrarPort |
整數 |
字串 |
登錄器服務所使用的 SIP 連接埠。如果登錄器使用預設連接埠 5061，則不需要此參數。 |
TargetFqdn |
選用 |
字串 |
要測試之群組擴充的登錄器集區完整網域名稱 (FQDN)。例如：-TargetFqdn "atl-cs-001.litwareinc.com"。 請注意，您無法在同一個命令中同時使用 TargetUri 參數和 TargetFqdn 參數。 |
TargetUri |
選用 |
字串 |
群組擴充 Web 服務的統一資源識別項 (URI)。例如：-TargetUri "https://atl-cs-001.litwareinc.com/groupexpansion"。 請注意，您無法在同一個命令中同時使用 TargetUri 參數和 TargetFqdn 參數。 |
UserCredential |
選用 |
PS 認證物件 |
要在測試中使用之使用者帳戶的使用者認證物件。傳送至 UserCredential 的值應該是使用 Get-Credential 指令程式所取得的物件參考。例如，此程式碼會傳回使用者 litwareinc\kenmyer 的認證物件，並將該物件儲存於名為 $x 的變數中： $x = Get-Credential "litwareinc\kenmyer" 執行這個命令時，您將需要提供使用者密碼。 如果您在登入使用者認證之下執行測試並使用 TargetFqdn 參數，則不需要使用者認證。若您使用 TargetUri 參數則需要使用者認證。 |
UserSipAddress |
選用 |
字串 |
要在測試中使用之使用者的 SIP 位址。若未指定此參數，則 Test-CsGroupExpansion 將會使用登入使用者的帳戶進行其檢查。 |
WebCredential |
選用 |
PS 認證物件 |
包含用於存取位置資訊服務的使用者認證物件。此物件可透過呼叫 Get-Credential Cmdlet 並提供適當的認證來擷取。 如果指定了 TargetUri 和 UserSipAddress 參數，而且執行命令的電腦不具伺服器憑證，則此為必要參數。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
OutVerboseVariable |
選用 |
字串 |
此參數存在時，會以指定的變數儲存執行 Cmdlet 的詳細輸出。例如，若要以名稱為 $TestOutput 的變數儲存輸出，請使用下列語法： -OutVerboseVariable TestOutput 指定變數名稱時，請勿在前面加上 $ 字元。 |
Verbose |
選用 |
GUID |
指令程式執行時，在畫面上的詳細活動報告。 |
輸入類型
無。Test-CsGroupExpansion 不會接受管線傳送的資料。
傳回類型
Test-CsGroupExpansion 會傳回 Microsoft.Rtc.SyntheticTransactions.TaskOutput 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Test-CsGroupExpansion -TargetFqdn atl-cs-001.litwareinc.com -GroupEmailAddress FinanceGroup@litwareinc.com
範例 1 所示的命令可連接至登錄器集區 atl-cs-001.litwareinc.com，以確認群組擴充。該命令使用 FinanceGroup@litwareinc.com 群組來進行測試。