Remove-CsHealthMonitoringConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-26

Entfernt eine vorhandene Auflistung von Konfigurationseinstellungen für die 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

Remove-CsHealthMonitoringConfiguration -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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.

Das Cmdlet Remove-CsHealthMonitoringConfiguration bietet die Möglichkeit, sämtliche Konfigurationseinstellungen für die Integritätsüberwachung zu entfernen, die für die Verwendung in Ihrer Organisation konfiguriert wurden.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Vollqualifizierter Domänenname (FQDN) des Pools, der die zu löschenden Konfigurationseinstellungen für die Integritätsüberwachung hostet. Beispiel: -Identity atl-cs-001.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. Remove-CsHealthMonitoringConfiguration akzeptiert weitergeleitete Instanzen von Konfigurationsobjekten für die Integritätsüberwachung.

Rückgabetypen

Keine. Mit Remove-CsHealthMonitoringConfiguration werden stattdessen vorhandene Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.HealthMonitoring.HealthMonitoringSettings" gelöscht.

Beispiel

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

Remove-CsHealthMonitoringConfiguration -Identity atl-cs-001.litwareinc.com

Der Befehl in Beispiel 1 löscht die Auflistung der Konfigurationseinstellungen für die Integritätsüberwachung mit dem Identitätswert "atl-cs-001.litwareinc.com". Da Identitätswerte eindeutig sein müssen, wird über diesen Befehl maximal eine Auflistung von Einstellungen gelöscht.

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

Get-CsHealthMonitoringConfiguration | Remove-CsHealthMonitoringConfiguration 

Mit dem Befehl in Beispiel 2 werden alle derzeit verwendeten Konfigurationseinstellungen für die Integritätsüberwachung gelöscht. Hierzu ruft der Befehl zunächst Get-CsHealthMonitoringConfiguration ohne Parameter auf. Damit wird eine Auflistung aller in der Organisation verwendeten Konfigurationseinstellungen für die Integritätsüberwachung zurückgegeben. Diese Auflistung wird dann an das Cmdlet Remove-CsHealthMonitoringConfiguration weitergeleitet, das jedes Element in der Auflistung löscht.

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

Get-CsHealthMonitoringConfiguration -Filter *.litwareinc.com  | Remove-CsHealthMonitoringConfiguration 

Im vorstehenden Beispiel werden alle Konfigurationseinstellungen für die Integritätsüberwachung zurückgegeben, die für die Domäne "litwareinc.com" erstellt wurden. Hierzu wird Get-CsHealthMonitoringConfiguration mit dem Parameter "Filter" aufgerufen. Der Filterwert "*.litwareinc.com" stellt sicher, dass nur Einstellungen zurückgegeben werden, deren Identitätswert auf den Zeichenfolgenwert ".litwareinc.com" endet. Diese gefilterte Auflistung wird dann an das Cmdlet Remove-CsHealthMonitoringConfiguration weitergeleitet, das jedes Element in der Auflistung löscht.

-------------------------- Beispiel 4 ------------------------

(Get-CsHealthMonitoringConfiguration | Where-Object {$_.FirstTestUserSipUri -eq "sip:kenmyer@litwareinc.com" -or $_.SecondTestUserSipUri -eq " sip:kenmyer@litwareinc.com"}) | Remove-CsHealthMonitoringConfiguration

Der Befehl in Beispiel 4 löscht alle Konfigurationseinstellungen für die Integritätsüberwachung, die den Benutzer mit der SIP-Adresse "sip:kenmyer@litwareinc.com" als einen der Testbenutzer enthält. Hierzu ruft der Befehl zunächst Get-CsHealthMonitoringConfiguration ohne 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 entweder die Eigenschaft "FirstTestUserSipUri" oder die Eigenschaft "SecondTestUserSipUri" den Wert "sip:kenmyer@litwareinc.com" aufweist. Diese Einstellungen werden anschließend an Remove-CsHealthMonitoringConfiguration weitergeleitet und gelöscht.