Test-UMConnectivity
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Letztes Änderungsdatum des Themas: 2008-01-30
Das Cmdlet Test-UMConnectivity kann zum Testen des Betriebs eines Computers verwendet werden, auf dem die Serverfunktion UnifiedMessaging installiert ist.
Syntax
test-UMConnectivity [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Fax <$true | $false>] [-ListenPort <Int32>] [-MediaSecured <$true | $false>] [-MonitoringContext <$true | $false>] [-RemotePort <Int32>] [-Secured <$true | $false>] [-Timeout <Int32>] [-WhatIf [<SwitchParameter>]]
test-UMConnectivity -TUILogonAll <$true | $false> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ListenPort <Int32>] [-MediaSecured <$true | $false>] [-MonitoringContext <$true | $false>] [-RemotePort <Int32>] [-Secured <$true | $false>] [-Timeout <Int32>] [-WhatIf [<SwitchParameter>]]
test-UMConnectivity -ResetPIN <$true | $false> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-MonitoringContext <$true | $false>] [-WhatIf [<SwitchParameter>]]
test-UMConnectivity -Phone <String> -UMIPGateway <UMIPGatewayIdParameter> [-Confirm [<SwitchParameter>]] [-DiagDtmfDurationInMilisecs <Int32>] [-DiagDtmfSequence <String>] [-DiagInitialSilenceInMilisecs <Int32>] [-DiagInterDtmfDiffGapInMilisecs <String>] [-DiagInterDtmfGapInMilisecs <Int32>] [-DomainController <Fqdn>] [-Fax <$true | $false>] [-From <String>] [-ListenPort <Int32>] [-MediaSecured <$true | $false>] [-MonitoringContext <$true | $false>] [-Secured <$true | $false>] [-Timeout <Int32>] [-WhatIf [<SwitchParameter>]]
test-UMConnectivity -Phone <String> -PIN <String> -TUILogon <$true | $false> -UMDialPlan <UMDialPlanIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ListenPort <Int32>] [-MediaSecured <$true | $false>] [-MonitoringContext <$true | $false>] [-RemotePort <Int32>] [-Secured <$true | $false>] [-Timeout <Int32>] [-WhatIf [<SwitchParameter>]]
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 UMIPGateway 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 dem verwendeten Konto die Rolle Exchange-Serveradministrator zugewiesen worden sein, und es muss der lokalen Gruppe Administratoren für den Zielserver angehören.
Weitere Informationen zu Berechtigungen, zum Delegieren von Rollen und zu den Rechten, die für die Verwaltung von Exchange 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Phone |
Erforderlich |
System.String |
Dieser Parameter gibt die Telefonnummer oder den SIP-URI an, die/der 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. |
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. |
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". |
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. |
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. |
Confirm |
Optional |
System.Management.Automation.SwitchParameter |
Dieser Parameter bewirkt eine Unterbrechung der Befehlsausführung und zwingt den Benutzer, die Aktion des Befehls zu bestätigen, bevor die Verarbeitung fortgesetzt wird. Der Standardwert lautet "$true". |
DiagDtmfDurationInMilisecs |
Optional |
System.Int32 |
Dieser Parameter gibt die Dauer jeder gesendeten Ziffer an. |
DiagDtmfSequence |
Optional |
System.String |
Dieser Parameter gibt die Reihenfolge der gesendeten Ziffern an. |
DiagInitialSilenceInMilisecs |
Optional |
System.Int32 |
Dieser Parameter gibt den Zeitraum an (Millisekunden), während dem das Cmdlet anhält, bevor die Ziffernfolge gesendet wird. |
DiagInterDtmfDiffGapInMilisecs |
Optional |
System.String |
Dieser Parameter wird zum Anpassen der Zeit zwischen den Ziffern in der Diagnosereihenfolge verwendet. Dies ist eine durch Kommas getrennte Liste, die einen oder mehrere Nulleinträge enthalten kann. |
DiagInterDtmfGapInMilisecs |
Optional |
System.Int32 |
Dieser Parameter gibt die Zeit in Millisekunden zwischen jeder Ziffer an, die in der Ziffernfolge gesendet wird. Hierbei handelt es sich um einen Einzelwert. |
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
Dieser Parameter gibt den vollqualifizierten Domänennamen (FQDN) des Domänencontrollers an, der diese Konfigurationsänderung in den Active Directory-Verzeichnisdienst schreibt. |
Fax |
Optional |
System.Boolean |
Dieser Parameter gibt an, dass es sich bei dem getesteten Anruf um einen Faxanruf handelt. Die Standardeinstellung ist |
From |
Optional |
System.String |
Dieser Parameter gibt den SIP-URI oder die SIP-Adresse an, von der der Anruf stammte. Er wird nur zusammen mit dem Parameter -Phone verwendet. Die Standardeinstellung ist der bei Verwendung des Parameters -Phone angegebene SIP-URI. |
ListenPort |
Optional |
System.Int32 |
Dieser Parameter gibt den IP-Port an, der überwacht werden soll. Erfolgt keine Angabe, wird IP-Port 9000 verwendet. |
MediaSecured |
Optional |
System.Boolean |
Dieser Parameter gibt an, ob Secure RTP oder der ungesicherte Modus verwendet werden soll. |
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. |
RemotePort |
Optional |
System.Int32 |
Dieser Parameter gibt den Port an, der für den Anruf verwendet wird. Wenn nicht angegeben, lautet der Standardport 5060 für TCP und 5061 für MTLS. |
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. |
WhatIf |
Optional |
System.Management.Automation.SwitchParameter |
Dieser Parameter weist den Befehl an, die Aktionen zu simulieren, die für das Objekt ausgeführt würden. Durch Verwendung des WhatIf-Parameters können Sie eine Vorschau der Änderungen anzeigen, ohne diese Änderungen wirklich übernehmen zu müssen. Der Standardwert lautet "$true". |
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.
Das dritte Beispiel testet die Teilnehmerzugriffsnummer eines Wählplans durch Verwenden eines SIP-URI. Dieses Beispiel kann in einer Umgebung mit Microsoft Office Communications Server 2007 verwendet werden.
Das vierte Beispiel testet eine automatische Telefonzentrale durch Verwenden eines SIP-URI. Dieses Beispiel wird in einer Umgebung mit Communications Server 2007 verwendet.
Test-UMConnectivity
Test-UMConnectivity -UMIPGateway MyUMIPGateway -Phone 56780 -Secured $false
Test-UMConnectivity -UMIPGateway OCSGateway1 -Phone "sip:SIPdialplan.contoso.com@contoso.com"
Test-UMConnectivity -UMIPGateway OCSGateway1 -Phone "sip:SIPAutoAttendant.SIPDialPlan.contoso.com@contoso.com"