Test-UMConnectivity (RTM)
Gilt für: Exchange Server 2007
Letztes Änderungsdatum des Themas: 2007-10-02
Das Cmdlet Test-UMConnectivity kann zum Testen des Betriebs eines Computers verwendet werden, auf dem die Serverfunktion UnifiedMessaging installiert ist.
Syntax
test-UMConnectivity [-DomainController <Fqdn>] [-Fax <$true | $false>] [-ListenPort <Int32>] [-MonitoringContext <$true | $false>] [-Secured <$true | $false>] [-Timeout <Int32>]
test-UMConnectivity -ResetPIN <$true | $false> [-DomainController <Fqdn>] [-MonitoringContext <$true | $false>]
test-UMConnectivity -Phone <String> -UMIPGateway <UMIPGatewayIdParameter> [-DomainController <Fqdn>] [-Fax <$true | $false>] [-ListenPort <Int32>] [-MonitoringContext <$true | $false>] [-Secured <$true | $false>] [-Timeout <Int32>]
test-UMConnectivity -TUILogonAll <$true | $false> [-DomainController <Fqdn>] [-ListenPort <Int32>] [-MonitoringContext <$true | $false>] [-Secured <$true | $false>] [-Timeout <Int32>]
test-UMConnectivity -Phone <String> -PIN <String> -TUILogon <$true | $false> -UMDialPlan <UMDialPlanIdParameter> [-DomainController <Fqdn>] [-ListenPort <Int32>] [-MonitoringContext <$true | $false>] [-Secured <$true | $false>] [-Timeout <Int32>]
Detaillierte Beschreibung
Die beiden Diagnosetests dienen zum Testen des Betriebs der Microsoft Exchange Server 2007 Unified Messaging-Serversoftware (Modus 1) und des Betriebs des gesamten Systems einschließlich der angeschlossenen Telefoniekomponenten (Modus 2).
Das Cmdlet Test-UMConnectivity kann zum Testen des Betriebs eines Unified Messaging-Servers (UM-Servers) und der zugehörigen verbundenen Telefoniegeräten verwendet werden. Wenn ein Administrator dieses Cmdlet mit dem Parameter IPGateway ausführt, testet der Unified Messaging-Server den vollständigen End-to-End-Betrieb des UM-Systems. Dies schließt die mit dem Unified Messaging-Server verbundenen Telefoniekomponenten einschließlich IP-Gateways, PBX-Ressourcen (Private Branch eXchanges, Nebenstellenanlagen) und Verkabelung ein. Wird der Parameter IPGateway nicht angegeben, testet der Unified Messaging-Server nur den Betrieb der UM-Komponenten, die auf dem Server installiert und konfiguriert sind.
Damit Sie das Cmdlet Test-UMConnectivity ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:
- die Rolle Exchange-Serveradministrator und die Mitgliedschaft in der lokalen Gruppe Administratoren für den Zielserver
Weitere Informationen zu Berechtigungen, zum Delegieren von Rollen und zu den Rechten, die für die Verwaltung von Exchange Server 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Phone |
Erforderlich |
System.String |
Dieser Parameter gibt die Telefonnummer an, die bei der Umleitung des Testanrufs verwendet wird. Die Durchwahlnummer sollte in der PBX-Ressource so konfiguriert sein, dass der Anruf an den UM-Sammelanschluss weitergeleitet wird. |
PIN |
Erforderlich |
System.String |
Mit diesem Parameter können Sie die PIN angeben, die dem UM-aktivierten Postfach zugeordnet ist. |
TUILogon |
Erforderlich |
System.Boolean |
Dieser Parameter gibt an, ob das Cmdlet versuchen soll, sich an mindestens einem UM-aktivierten Postfach anzumelden. Die Postfächer müssen UM-aktiviert und dem UM-Wählplan zugeordnet sein, zu dem der Unified Messaging-Server gehört. Die Standardeinstellung ist "false". |
TUILogonAll |
Erforderlich |
System.Boolean |
Dieser Parameter gibt an, ob alle Postfächer am aktuellen Active Directory-Standort getestet werden sollen. Anschließend wird die Verbindung mit jedem UM-aktivierten Postfach getestet. Die Standardeinstellung ist "false". |
UMIPGateway |
Erforderlich |
Microsoft.Exchange.Configuration.Tasks.UMIPGatewayIdParameter |
Dieser Parameter gibt den Namen des für den ausgehenden Testanruf zu verwendenden UM-IP-Gateways oder der IP-PBX-Ressource an. |
UMDialPlan |
Erforderlich |
Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter |
Dieser Parameter gibt den UM-Wählplan an, der in getestet werden soll. Dieser Parameter muss mit dem Parameter TUILogin verwendet werden. |
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
Der Parameter DomainController gibt den Domänencontroller an, der zum Schreiben dieser Konfigurationsänderung in Active Directory verwendet werden soll. Verwenden Sie den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Domänencontrollers, der verwendet werden soll. |
Fax |
Optional |
System.Boolean |
Dieser Parameter gibt an, dass es sich bei dem getesteten Anruf um einen Faxanruf handelt. Die Standardeinstellung ist |
ListenPort |
Optional |
System.Int32 |
Dieser Parameter gibt den IP-Port an, der überwacht werden soll. Erfolgt keine Angabe, wird IP-Port 9000 verwendet. |
MonitoringContext |
Optional |
System.Boolean |
Dieser Parameter gibt an, ob das Cmdlet in einer Befehlszeile ausgeführt oder das Ausgabeobjekt an Microsoft Operations Manager übergeben wird. Standardmäßig wird das Cmdlet in einer Befehlszeile ausgeführt. |
Secured |
Optional |
System.Boolean |
Dieser Parameter gibt an, ob der Test im gesicherten Modus ausgeführt wird. |
Timeout |
Optional |
System.Int32 |
Dieser Parameter gibt die Länge des Wartezeitraums (in Sekunden) für den Abschluss des Testvorgangs an. Der Standardwert ist 180 Sekunden. Sie können diesen Parameter auf einen Wert von unter 5 Sekunden festlegen. Es wird jedoch empfohlen, diesen Parameter immer mit einem Wert von mindestens 5 Sekunden zu konfigurieren. |
ResetPIN |
Erforderlich |
System.Boolean |
Dieser Parameter gibt an, ob eine neue PIN für alle Testpostfächer am aktuellen Standort generiert oder erneut generiert werden soll. |
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
Der Parameter DomainController gibt den Domänencontroller an, der zum Schreiben dieser Konfigurationsänderung in Active Directory verwendet werden soll. Verwenden Sie den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Domänencontrollers, der verwendet werden soll. |
Eingabetypen
Rückgabetypen
Fehler
| Fehler | Beschreibung |
|---|---|
|
|
Ausnahmen
| Ausnahmen | Beschreibung |
|---|---|
|
|
Beispiel
Das erste Beispiel führt Verbindungs- und Betriebstests für den lokalen Unified Messaging-Server aus und zeigt dann VoIP-Verbindungsinformationen (Voice over IP) an.
Das zweite Beispiel testet die Möglichkeit des lokalen Unified Messaging-Servers, eine nicht gesicherte TCP-Verbindung (Transmission Control Protocol) anstatt einer sicheren MTLS-Verbindung (Mutual Transport Layer Security) zu verwenden, um einen Anruf über einen UM-IP-Gateway namens MyUMIPGateway mithilfe der Telefonnummer 56780 zu tätigen.
Test-UMConnectivity
Test-UMConnectivity -UMIPGateway MyUMIPGateway -Phone 56780 -Secured $false