Set-CsHealthMonitoringConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-25

Ändert eine vorhandene Auflistung von Konfigurationseinstellungen der Integritätsüberwachung. Mit diesen Einstellungen können Administratoren Qualitätssicherungstests durchführen, ohne die Benutzernamen und Kennwörter für die erforderlichen Testkonten bereitstellen zu müssen.

Syntax

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>]]

Detaillierte Beschreibung

Anhand synthetischer Transaktionen wird in Microsoft Lync Server 2010 überprüft, ob Benutzer allgemeine Aufgaben wie z. B. das Anmelden beim System, das Austauschen von Sofortnachrichten oder das Tätigen von Anrufen im Telefonfestnetz (Public Switched Telephone Network, PSTN) erfolgreich durchführen können. Diese Tests können manuell von einem Administrator oder automatisch von einer Anwendung wie Microsoft System Center Operations Manager (früher Microsoft Operations Manager) durchgeführt werden.

Synthetische Transaktionen können auf zwei verschiedene Arten durchgeführt werden. Viele Administratoren verwenden die CsHealthMonitoringConfiguration-Cmdlets, um für jeden Registrierungspool Testkonten einzurichten. Bei diesen Testkonten handelt es sich um zwei Benutzerkonten, die für synthetische Transaktionen vorkonfiguriert wurden. (Dies sind in der Regel Testkonten und keine Konten von tatsächlich vorhandenen Benutzern.) Wenn Testkonten für einen Pool konfiguriert wurden, können Administratoren eine synthetische Transaktion für diesen Pool durchführen, ohne die Identitätswerte (und die Anmeldeinformationen) der für den Test verwendeten Benutzerkonten anzugeben. Stattdessen verwendet die synthetische Transaktion automatisch die vorkonfigurierten Testkonten für die Tests.

Administratoren können eine synthetische Transaktion allerdings auch mit tatsächlichen Benutzerkonten ausführen. Wenn z. B. zwei Benutzer keine Sofortnachrichten austauschen können, kann der Administrator eine synthetische Transaktion mit diesen zwei Benutzerkonten durchführen, statt hierfür zwei Testkonten zu verwenden. Denken Sie beim Ausführen einer synthetischen Transaktion mit tatsächlichen Benutzerkonten daran, dass Sie die Anmeldeinformationen für jeden Benutzer angeben müssen.

Nachdem Sie Konfigurationseinstellungen für die Identitätsüberwachung konfiguriert haben, können Sie diese Einstellungen jederzeit mit dem Cmdlet Set-CsHealthMonitoringConfiguration ändern. Dieses Cmdlet bietet Ihnen die Möglichkeit, die Testkonten zu ändern, die für die Verwendung mit einem Pool konfiguriert wurden.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Set-CsHealthMonitoringConfiguration lokal ausführen: RTCUniversalServerAdmins. Geben Sie den folgenden Befehl an der Windows PowerShell-Eingabeaufforderung ein, um eine Liste aller rollenbasierten Zugriffssteuerungsrollen zurückzugeben, die diesem Cmdlet zugewiesen wurden (einschließlich der benutzerdefinierten rollenbasierten Zugriffssteuerungsrollen, die Sie selbst erstellt haben):

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsHealthMonitoringConfiguration"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

FQDN

Vollqualifizierter Domänenname (FQDN) des Pools, in dem die zu ändernden Konfigurationseinstellungen der Integritätsüberwachung zugewiesen wurden. Beispiel: -Identity atl-cs-001.litwareinc.com.

Instance

Optional

HealthMonitoringSettings-Objekt

Ermöglicht Ihnen, einen Verweis auf ein Objekt an das Cmdlet zu übergeben, statt individuelle Parameterwerte festzulegen.

FirstTestSamAccountName

Optional

Zeichenfolge

"SamAccountName" des ersten Testbenutzers. Der Wert für "FirstTestSamAccountName" im im Format "Domäne\Benutzername" angegeben werden. Beispiel:

-FirstTestSamAccountName litwareinc\kenmyer

FirstTestUserSipUri

Optional

SIP-Adresse

SIP-Adresse des ersten Testbenutzers, der für diese Auflistung mit Einstellungen für die Integritätsüberwachung konfiguriert wird. Beachten Sie, dass die SIP-Adresse das Präfix "sip:" enthalten muss. Beispiel: -FirstTestUserSipUri "sip:kenmyer@litwareinc.com".

SecondTestSamAccountName

Optional

Zeichenfolge

"SamAccountName" des zweiten Testbenutzers. Der Wert für "SecondTestSamAccountName" im im Format "Domäne\Benutzername" angegeben werden. Beispiel:

-SecondTestSamAccountName litwareinc\pilar

SecondTestUserSipUri

Optional

SIP-Adresse

SIP-Adresse des zweiten Testbenutzers, der für diese Auflistung mit Einstellungen für die Integritätsüberwachung konfiguriert wird. Beachten Sie, dass die SIP-Adresse das Präfix "sip:" enthalten muss. Beispiel: -FirstTestUserSipUri "sip:pilar@litwareinc.com".

Force

Optional

Switch-Parameter

Unterdrückt die Anzeige von Meldungen bei nicht schwerwiegenden Fehlern, die beim Ausführen des Befehls auftreten können.

WhatIf

Optional

Switch-Parameter

Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.

Confirm

Optional

Switch-Parameter

Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf.

Eingabetypen

Microsoft.Rtc.Management.WritableConfig.Settings.HealthMonitoring.HealthMonitoringSettings-Objekt. Set-CsHealthMonitoringConfiguration akzeptiert weitergeleitete Instanzen von Konfigurationsobjekten für die Integritätsüberwachung.

Rückgabetypen

Keine. Mit Set-CsHealthMonitoringConfiguration werden stattdessen vorhandene Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.HealthMonitoring.HealthMonitoringSettings" geändert.

Beispiel

-------------------------- Beispiel 1 ------------------------

Set-CsHealthMonitoringConfiguration -Identity atl-cs-001.litwareinc.com -FirstTestUserSipUri "sip:kenmyer@litwareinc.com" -FirstTestSamAccountName "litwareinc\kenmyer"

Der Befehl in Beispiel 1 konfiguriert den ersten Testbenutzer, der den Konfigurationseinstellungen für die Integritätsüberwachung für den Pool "atl-cs-001.litwareinc.com" zugewiesen ist. In diesem Beispiel wird die SIP-Adresse für den neuen Testbenutzer auf "sip:kenmyer@litwareinc.com" und der Parameter "SamAccountName" für den Testbenutzer auf "kenmyer" festgelegt.

-------------------------- Beispiel 2 ------------------------

Get-CsHealthMonitoringConfiguration | Set-CsHealthMonitoringConfiguration -FirstTestUserSipUri "sip:kenmyer@litwareinc.com" -FirstTestSamAccountName "litwareinc\kenmyer"

Der vorstehende Befehl ist eine Variante des Befehls in Beispiel 1. In diesem Fall wird jedoch derselbe Testbenutzer jeder Auflistung von Konfigurationseinstellungen für die Integritätsüberwachung zugewiesen, die in der Organisation verwendet werden. Hierzu ruft der Befehl zunächst Get-CsHealthMonitoringConfiguration auf, um eine Auflistung aller Konfigurationseinstellungen für die Integritätsüberwachung zurückzugeben. Diese Auflistung wird dann an Set-CsHealthMonitoringConfiguration weitergeleitet, um die SIP-Adresse und den Parameter "SamAccountName" desselben ersten Testbenutzers jedem Element in der Auflistung zuzuweisen.

-------------------------- Beispiel 3 ------------------------

Get-CsHealthMonitoringConfiguration | Where-Object {$_.FirstTestUserSipUri -eq "sip:pilar@litwareinc.com"} | Set-CsHealthMonitoringConfiguration -FirstTestUserSipUri "sip:kenmyer@litwareinc.com" -FirstTestSamAccountName "litwareinc\kenmyer"

In Beispiel 3 wird dargestellt, wie Sie einen Suchen-und-Ersetzen-Vorgang für den ersten Testbenutzer durchführen können, der einer Auflistung von Konfigurationseinstellungen für die Integritätsüberwachung zugewiesen ist. In diesem Beispiel wird der Benutzer mit der SIP-Adresse "sip:pilar@litwareinc.com" immer dann ersetzt, wenn dieser Benutzer den ersten Testbenutzer in einer Auflistung darstellt.

Hierzu ruft der Befehl zunächst Get-CsHealthMonitoringConfiguration ohne zusätzliche Parameter auf. Damit wird eine Auflistung aller Konfigurationseinstellungen für die Integritätsüberwachung zurückgegeben, die derzeit in der Organisation verwendet werden. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Einstellungen herausfiltert, bei denen die Eigenschaft "FirstTestUserSipUri" den Wert "sip:pilar@litwareinc.com" aufweist (der Vergleichsoperator "-eq" steht für "equal to"). Diese gefilterte Auflistung wird dann an das Cmdlet Set-CsHealthMonitoringConfiguration weitergeleitet, das bei jedem Element in der Auflistung den Wert der Eigenschaft "FirstTestUserSipUri" auf "sip:kenmyer@litwareinc.com" und den Wert der Eigenschaft "FirstTestSamAccountName" auf "kenmyer" festlegt.