New-CsHealthMonitoringConfiguration

Syntax

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

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.

Mit dem Cmdlet New-CsHealthMonitoringConfiguration können Sie neue Konfigurationseinstellungen für die Integritätsüberwachung für einen Registrierungs- oder Directorpool erstellen. Beim Erstellen einer neuen Auflistung mit Konfigurationseinstellungen für die Integritätsüberwachung müssen Sie den vollqualifizierten Domänennamen (FQDN) des Pools sowie die SIP-Adressen der zwei Konten angeben, die als Pooltestkonten dienen. (Sie müssen jedoch keine Kennwörter für diese Testkonten angeben.) Beachten Sie, dass jeder Pool nur eine Auflistung mit Konfigurationseinstellungen für die Integritätsüberwachung hosten kann. Wenn Sie versuchen, eine neue Auflistung für den Pool "atl-cs-001.litwareinc.com" zu erstellen, und diesem Pool bereits eine Registrierung zugewiesen wurde, verursacht der Befehl einen Fehler.

Bei der Ausführung von "New-CsHealthMonitoringConfiguration" erhalten Sie möglicherweise eine Warnung, wenn einem oder mehreren Pools keine Testbenutzer zugewiesen wurden. Dies betrifft sowohl Directorpools als auch Office Communications Server-Pools. Diese Warnungen können ignoriert werden. Nach Bedarf können Sie Ihren Directorpools Testbenutzer zuweisen, die anderen Pools angehören; auf diese Weise können Sie das Cmdlet "Test-CsRegistration" für den Director ausführen. Testbenutzer können jedoch keinen Office Communications Server-Pools zugewiesen werden.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet New-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 "New-CsHealthMonitoringConfiguration"}

Parameter

Eingabetypen

Keine. New-CsHealthMonitoringConfiguration akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Mit New-CsHealthMonitoringConfiguration werden neue Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.HealthMonitoring.HealthMonitoringSettings" erstellt.

Beispiel

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

New-CsHealthMonitoringConfiguration -Identity atl-cs-001.litwareinc.com -FirstTestUserSipUri "sip:kenmyer@litwareinc.com" -SecondTestUserSipUri "sip:pilar@litwareinc.com"

Der Befehl in Beispiel 1 erstellt eine neue Auflistung mit Konfigurationseinstellungen für die Integritätsüberwachung für den Pool "atl-cs-001.litwareinc.com". Diese neuen Einstellungen verwenden "sip:kenmyer@litwareinc.com" und "sip:pilar@litwareinc.com" als vorkonfigurierte Testkonten.

-------------------------- Beispiel 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"}

In Beispiel 2 wird eine neue Auflistung mit Konfigurationseinstellungen für die Integritätsüberwachung für alle Registrierungspools in der Organisation erstellt. Hierzu werden im ersten Befehl im Beispiel das Cmdlet Get-Service und der Parameter "Registrar" verwendet, um eine Auflistung aller Registrierungspools zurückzugeben. Diese Auflistung wird anschließend an das Cmdlet Select-Object weitergeleitet, das nur die Eigenschaft "PoolFqdn" herausfiltert. (Diese Eigenschaft gibt den FQDN eines Registrierungspools zurück.) Diese FQDNs werden in der Variablen "$x" gespeichert.

Im zweiten Befehl wird eine Foreach-Schleife erstellt, um die FQDNs aller Registrierungspools zu durchlaufen. Für jeden FQDN wird New-CsHealthMonitoringConfiguration aufgerufen, um eine neue Auflistung mit Konfigurationseinstellungen zu erstellen. Hierbei wird der in "$x" gespeicherte FQDN als Identitätswert für die neue Auflistung verwendet. Jeder Auflistung werden außerdem dieselben beiden Testkonten zugewiesen: "sip:kenmyer@litwareinc.com" und "sip:pilar@litwareinc.com".

Siehe auch

Weitere Ressourcen

Get-CsHealthMonitoringConfiguration
Remove-CsHealthMonitoringConfiguration
Set-CsHealthMonitoringConfiguration