Set-CsHealthMonitoringConfiguration
上次修改主題的時間： 2012-03-25
修改現有的健全狀況監視組態設定集合。這些設定可讓系統管理員不必提供所需測試帳戶的使用者名稱與密碼，即可執行品質保證測試。
語法
Set-CsHealthMonitoringConfiguration [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-FirstTestSamAccountName <String>] [-FirstTestUserSipUri <String>] [-Force <SwitchParameter>] [-SecondTestSamAccountName <String>] [-SecondTestUserSipUri <String>] [-WhatIf [<SwitchParameter>]]
Set-CsHealthMonitoringConfiguration [-Confirm [<SwitchParameter>]] [-FirstTestSamAccountName <String>] [-FirstTestUserSipUri <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-SecondTestSamAccountName <String>] [-SecondTestUserSipUri <String>] [-WhatIf [<SwitchParameter>]]
詳細描述
Microsoft Lync Server 2010 中會使用綜合交易來確認使用者可以順利完成一般工作，例如登入系統、交換立即訊息，或打給位於公用交換電話網路 (PSTN) 的電話。這些測試可由系統管理員手動執行，或由 Microsoft System Center Operations Manager (舊稱為 Microsoft Operations Manager) 這類應用程式自動執行。
有兩種不同的方式可執行綜合交易。許多系統管理員會使用 CsHealthMonitoringConfiguration 指令程式來設定其每個登錄器集區的測試帳戶。這些測試帳戶是已預先設定要搭配使用綜合交易的一對使用者帳戶。(通常這些使用者是測試帳戶，而不是屬於真正使用者的帳戶)。對集區設定測試帳戶時，系統管理員只要對集區執行綜合交易，無須指定測試中牽涉之使用者帳戶的識別身分 (並提供其認證)。相對的，綜合交易在執行檢查時，會自動使用預先設定的測試帳戶。
另一種方式是系統管理員會使用真正的使用者帳戶來執行綜合交易。例如，如果有兩位使用者無法交換立即訊息，則系統管理員可使用這兩個有問題的使用者帳戶來執行綜合交易 (而不是使用一對的測試帳戶)。如果您決定使用真正的使用者帳戶來執行綜合交易，您必須提供每位使用者的認證。
在您設定好運作狀況監視組態設定後，您可以隨時使用 Set-CsHealthMonitoringConfiguration 指令程式來修改這些設定。此指令程式可讓您變更設定與集區搭配使用之其中一個 (或兩個) 測試帳戶。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsHealthMonitoringConfiguration Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsHealthMonitoringConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
FQDN |
已指派要修改之狀況監控組態設定的集區完整網域名稱 (FQDN)。例如：-Identity atl-cs-001.litwareinc.com。 |
Instance |
選用 |
HealthMonitoringSettings 物件 |
允許您將物件參照傳遞給 Cmdlet，而不設定個別參數值。 |
FirstTestSamAccountName |
選用 |
字串 |
第一個測試使用者的 SamAccountName。必須使用「網域\使用者名稱」的格式輸入 FirstTestSamAccountName；例如： -FirstTestSamAccountName litwareinc\kenmyer |
FirstTestUserSipUri |
選用 |
SIP 位址 |
第一個透過此健全狀況監視設定集合所設定使用之測試使用者 SIP 位址。請注意，SIP 位址必須包含 sip:前置字元。例如：-FirstTestUserSipUri "sip:kenmyer@litwareinc.com"。 |
SecondTestSamAccountName |
選用 |
字串 |
第二個測試使用者的 SamAccountName。必須使用「domain\username」的格式輸入 SecondTestSamAccountName；例如： -SecondTestSamAccountName litwareinc\pilar |
SecondTestUserSipUri |
選用 |
SIP 位址 |
第二個透過此健全狀況監視設定集合所設定使用之測試使用者 SIP 位址。請注意，SIP 位址必須包含 sip:前置字元。例如：-FirstTestUserSipUri "sip:pilar@litwareinc.com"。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
Microsoft.Rtc.Management.WritableConfig.Settings.HealthMonitoring.HealthMonitoringSettings 物件。Set-CsHealthMonitoringConfiguration 會接受運作狀況監控組態物件的管線傳送的執行個體。
傳回類型
無。而 Set-CsHealthMonitoringConfiguration 會修改 Microsoft.Rtc.Management.WritableConfig.Settings.HealthMonitoring.HealthMonitoringSettings 物件的現有執行個體。
範例
-------------------------- 範例 1 ------------------------
Set-CsHealthMonitoringConfiguration -Identity atl-cs-001.litwareinc.com -FirstTestUserSipUri "sip:kenmyer@litwareinc.com" -FirstTestSamAccountName "litwareinc\kenmyer"
範例 1 所示的命令會設定已指派給 atl-cs-001.litwareinc.com 集區之狀況監控組態設定的第一個測試使用者。在此範例中，新測試使用者的 SIP 位址會設為 sip:kenmyer@litwareinc.com，此測試使用者的 SamAccountName 會設為 kenmyer。
-------------------------- 範例 2 ------------------------
Get-CsHealthMonitoringConfiguration | Set-CsHealthMonitoringConfiguration -FirstTestUserSipUri "sip:kenmyer@litwareinc.com" -FirstTestSamAccountName "litwareinc\kenmyer"
上述命令是範例 1 所示之命令的變化，但在此例中，會將同一個測試使用者指派用於組織的每個健全狀況監視組態設定集合。為了完成此工作，命令會先使用 Get-CsHealthMonitoringConfiguration 傳回在所有狀況監控組態設定的集合。此集合便會被傳送到 Set-CsHealthMonitoringConfiguration，這樣會將相同的第一個測試使用者 SIP 位址與 SamAccountName 指派給集合中的每個項目。
-------------------------- 範例 3 ------------------------
Get-CsHealthMonitoringConfiguration | Where-Object {$_.FirstTestUserSipUri -eq "sip:pilar@litwareinc.com"} | Set-CsHealthMonitoringConfiguration -FirstTestUserSipUri "sip:kenmyer@litwareinc.com" -FirstTestSamAccountName "litwareinc\kenmyer"
範例 3 會顯示您如何搜尋與取代指派給健全狀況組態設定集合的第一個測試使用者；在此範例中，任何時候當 SIP 位址為 sip:pilar@litwareinc.com 的使用者顯示為集合中的第一個測試使用者時，該使用者就會被取代。
如果要執行這項作業，命令會先呼叫不含任何額外參數的 Get-CsHealthMonitoringConfiguration，以傳回目前用於組織的所有狀況監控組態設定的集合。此集合接著會被傳送到 Where-Object 指令程式，這樣只會挑選出 FirstTestUserSipUri 屬性等於 (-eq) sip:pilar@litwareinc.com 的項目。篩選後的集合便會傳送到 Set-CsHealthMonitoringConfiguration ，以取得集合中的每個項目，並將 FirstTestUserSipUri 屬性的值設為 sip:kenmyer@litwareinc.com，將 FirstTestSamAccountName 屬性的值設為 kenmyer。