New-CsHealthMonitoringConfiguration
上次修改主題的時間： 2012-03-26
建立用於組織中的新運作狀況監視組態設定集合。這些設定可讓系統管理員執行品質保證測試，而不需提供需要測試之帳戶的使用者名稱和密碼。
語法
New-CsHealthMonitoringConfiguration -Identity <XdsGlobalRelativeIdentity> -FirstTestUserSipUri <String> -SecondTestUserSipUri <String> [-Confirm [<SwitchParameter>]] [-FirstTestSamAccountName <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-SecondTestSamAccountName <String>] [-WhatIf [<SwitchParameter>]]
New-CsHealthMonitoringConfiguration -FirstTestUserSipUri <String> -SecondTestUserSipUri <String> -TargetFqdn <String> [-Confirm [<SwitchParameter>]] [-FirstTestSamAccountName <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-SecondTestSamAccountName <String>] [-WhatIf [<SwitchParameter>]]
詳細描述
Microsoft Lync Server 2010 中會使用綜合交易來確認使用者可以順利完成一般工作，例如登入系統、交換立即訊息，或打給位於公用交換電話網路 (PSTN) 的電話。這些測試可由系統管理員「手動」執行，或由 Microsoft System Center Operations Manager (舊稱為 Microsoft Operations Manager) 這類應用程式自動執行。
綜合交易能夠以兩種不同的方式進行。許多系統管理員會使用 CsHealthMonitoringConfiguration 指令程式來設定其每個登錄器集區的測試帳戶。這些測試帳戶是已預先設定要搭配使用綜合交易的一對使用者帳戶。(通常這些使用者是測試帳戶，而不是屬於真正使用者的帳戶)。針對集區設定這些測試帳戶之後，系統管理員可以針對該集區執行綜合交易，而不必指定測試中涉及之使用者帳戶的身分識別 (以及提供其認證)。但是，綜合交易在執行其檢查時，會自動使用預先設定的測試帳戶。
或者，系統管理員可以使用實際的使用者帳戶執行綜合交易。例如，如果有兩個使用者無法交換立即訊息，系統管理員可以使用上述兩個使用者帳戶 (而非一組測試帳戶) 執行綜合交易。如果您決定使用實際的使用者帳戶執行綜合交易，則必須提供每個使用者的認證。
New-CsHealthMonitoringConfiguration 指令程式會提供一種方式，讓您建立登錄或 Director 集區的新運作狀況監視組態設定。建立新的狀況監控組態設定集合時，您必須指定集區的完整網域名稱 (FQDN)，以及將會當做集區測試帳戶之兩個帳戶的 SIP 位址。(不過，您不需要提供那些測試帳戶的密碼)。請注意，每個集區最多都可以裝載一個單一的運作狀況監視組態設定集合。如果您嘗試建立集區 atl-cs-001.litwareinc.com 的新集合，而且已為此集區指派登錄器，則您的命令將會失敗。
執行 New-CsHealthMonitoringConfiguration 時，如果某些集區尚未指派測試使用者，則可能會收到警告；這可能包括 Director 集區和 Office Communications Server 集區。可以略過這些警告。想要的話，您可以將隸屬於其他集區的測試使用者指派給 Direcotr 集區；這樣做可讓您針對 Director 執行 Test-CsRegistration 指令程式。但是，您不能將測試使用者指派到 Office Communications Server 集區。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsHealthMonitoringConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsHealthMonitoringConfiguration"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
選用 |
FQDN |
要指派之運作狀況監視組態設定之集區的 FQDN (例如：-Identity atl-cs-001.litwareinc.com)。如果指定的集區已經裝載一個運作狀況監視組態設定集合，您的命令將會失敗。 Identity 相當於 TargetFqdn 參數。建立新的設定集合時，您可以使用其中一個參數。如果您遺漏這兩個參數，New-CsHealthMonitoringConfiguration 將會提示您輸入 Identity。 |
TargetFqdn |
選用 |
FQDN |
要指派之運作狀況監視組態設定之集區的 FQDN (例如：-TargetFqdn atl-cs-001.litwareinc.com)。如果指定的集區已經裝載一個運作狀況監視組態設定集合，您的命令將會失敗。 TargetFqdn 相當於 Identity 參數。建立新的設定集合時，您可以使用其中一個參數。如果您遺漏這兩個參數，New-CsHealthMonitoringConfiguration 將會提示您輸入 Identity。 |
FirstTestSamAccountName |
選用 |
字串 |
第一個測試使用者的 SamAccountName。輸入 FirstTestSamAccountName 時，必須使用 domain\username 的格式，例如： -FirstTestSamAccountName litwareinc\kenmyer |
FirstTestUserSipUri |
選用 |
SIP 位址 |
設定為由此運作狀況監視設定集合使用之第一個測試使用者的 SIP 位址。請注意，SIP 位址必須包含 sip:首碼。例如：-FirstTestUserSipUri "sip:kenmyer@litwareinc.com"。 |
SecondTestSamAccountName |
選用 |
字串 |
第二個測試使用者的 SamAccountName。輸入 SecondTestSamAccountName 時，必須使用 domain\username 的格式，例如： -SecondTestSamAccountName litwareinc\pilar |
SecondTestUserSipUri |
選用 |
SIP 位址 |
設定為由此運作狀況監視設定集合使用之第二個測試使用者的 SIP 位址。請注意，SIP 位址必須包含 sip:首碼。例如：-SecondTestUserSipUri "sip:pilar@litwareinc.com"。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
InMemory |
選用 |
切換參數 |
建立物件參照，但而不實際將物件認可為永久變更。若將此參數所呼叫的 Cmdlet 輸出指派給變數，將可變更物件參照的屬性，然後呼叫此 Cmdlet 的對應 Set- Cmdlet 認可這些變更。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。New-CsHealthMonitoringConfiguration 不接受管線傳送的輸入。
傳回類型
New-CsHealthMonitoringConfiguration 會建立 Microsoft.Rtc.Management.WritableConfig.Settings.HealthMonitoring.HealthMonitoringSettings 物件的新執行個體。
範例
-------------------------- 範例 1 ------------------------
New-CsHealthMonitoringConfiguration -Identity atl-cs-001.litwareinc.com -FirstTestUserSipUri "sip:kenmyer@litwareinc.com" -SecondTestUserSipUri "sip:pilar@litwareinc.com"
範例 1 所示的命令會建立集區為 atl-cs-001.litwareinc.com 之運作狀況監視組態設定的新集合。這些新設定將會使用 sip:kenmyer@litwareinc.com 與 sip:pilar@litwareinc.com 作為預先設定的測試帳戶。
-------------------------- 範例 2 ------------------------
$x = Get-CsService -Registrar | Select-Object PoolFqdn
foreach ($i in $x)
{New-CsHealthMonitoringConfiguration -Identity $i.PoolFqdn -FirstTestUserSipUri "sip:kenmyer@litwareinc.com" -SecondTestUserSipUri "sip:pilar@litwareinc.com"}
範例 2 會針對組織中的所有登錄器集區，建立狀況監控組態設定的新集合。若要這樣做，範例中的第一個命令會使用 Get-Service 指令程式搭配 Registrar 參數，來傳回所有登錄器集區的集合。接著，此集合會傳送到 Select-Object 指令程式，只挑出 PoolFqdn 屬性。(這個內容會傳回登錄器集區的 FQDN)。這些 FQDN 會儲存在名為 $x 的變數中。
在第二個命令中，會建立 foreach 迴圈來不斷重複每個登錄器集區 FQDN。系統會針對每個 FQDN 呼叫 New-CsHealthMonitoringConfiguration，以建立新組態設定集合，其中 FQDN 以 $x 儲存，做為新集合的 Identity 使用。每個集合也會被指派兩個相同的測試帳戶：sip:kenmyer@litwareinc.com 和 sip:pilar@litwareinc.com。