Freigeben über

Test-UMConnectivity

  • Artikel

 

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 $true.

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"