Test-UMConnectivity
Dieses Cmdlet ist nur lokal in Exchange verfügbar.
Verwenden Sie das Cmdlet Test-UMConnectivity, um den Betrieb von Unified Messaging-Servern (UM) zu testen.
Hinweis: Dieses Cmdlet funktioniert am besten in Exchange 2010. In höheren Versionen von Exchange wurde die Funktionalität dieses Cmdlets durch verwaltete Verfügbarkeit ersetzt. Um optimale Ergebnisse zu erzielen, verwenden Sie das Cmdlet Invoke-MonitoringProbe, und geben Sie den relevanten aktiven Monitortest an, anstatt dieses Cmdlet zu verwenden.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
Test-UMConnectivity
-Phone <String>
-PIN <String>
-TUILogon <Boolean>
-UMDialPlan <UMDialPlanIdParameter>
[-CertificateThumbprint <String>]
[-Confirm]
[-DomainController <Fqdn>]
[-ListenPort <Int32>]
[-MediaSecured <Boolean>]
[-MonitoringContext <Boolean>]
[-RemotePort <Int32>]
[-Secured <Boolean>]
[-Timeout <Int32>]
[-WhatIf]
[<CommonParameters>]
Test-UMConnectivity
-Phone <String>
-UMIPGateway <UMIPGatewayIdParameter>
[-DiagDtmfDurationInMilisecs <Int32>]
[-DiagDtmfSequence <String>]
[-DiagInitialSilenceInMilisecs <Int32>]
[-DiagInterDtmfDiffGapInMilisecs <String>]
[-DiagInterDtmfGapInMilisecs <Int32>]
[-From <String>]
[-CertificateThumbprint <String>]
[-Confirm]
[-DomainController <Fqdn>]
[-ListenPort <Int32>]
[-MediaSecured <Boolean>]
[-MonitoringContext <Boolean>]
[-Secured <Boolean>]
[-Timeout <Int32>]
[-WhatIf]
[<CommonParameters>]
Test-UMConnectivity
-ResetPIN <Boolean>
[-Confirm]
[-DomainController <Fqdn>]
[-MonitoringContext <Boolean>]
[-WhatIf]
[<CommonParameters>]
Test-UMConnectivity
-TUILogonAll <Boolean>
[-CertificateThumbprint <String>]
[-Confirm]
[-DomainController <Fqdn>]
[-ListenPort <Int32>]
[-MediaSecured <Boolean>]
[-MonitoringContext <Boolean>]
[-RemotePort <Int32>]
[-Secured <Boolean>]
[-Timeout <Int32>]
[-WhatIf]
[<CommonParameters>]
Test-UMConnectivity
[-CallRouter]
[-CertificateThumbprint <String>]
[-Confirm]
[-DomainController <Fqdn>]
[-ListenPort <Int32>]
[-MediaSecured <Boolean>]
[-MonitoringContext <Boolean>]
[-RemotePort <Int32>]
[-Secured <Boolean>]
[-Timeout <Int32>]
[-WhatIf]
[<CommonParameters>]
Beschreibung
Zwei Diagnosetests dienen zum Testen des Betriebs der Postfachserversoftware (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 Postfachservers und der zugehörigen verbundenen Telefoniegeräte verwendet werden. Wenn Sie dieses Cmdlet ausführen und den Parameter UMIPGateway einschließen, testet der Postfachserver den vollständigen End-to-End-Betrieb des Unified Messaging-Systems. Dieser Test umfasst die telefoniekomponenten, die mit dem Postfachserver verbunden sind, z. B. IP-Gateways, Private Branch eXchanges (PBXs) und Verkabelung. Wird der Parameter UMIPGateway nicht angegeben, testet der Postfachserver nur den Betrieb der Unified Messaging-Komponenten, die auf dem Server installiert und konfiguriert sind.
Wenn Sie dieses Cmdlet in einer lokalen Unified Messaging-Bereitstellung ausführen, müssen Sie ein UM-IP-Gatewayobjekt für den Computer oder Server erstellen, den das Cmdlet testet. Wenn Sie das UM-IP-Gatewayobjekt erstellen, müssen Sie es mit einem vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) konfigurieren, und dieser FQDN muss dem Namen des Computers entsprechen, auf dem dieses Cmdlet ausgeführt wird.
Nach Beendigung dieser Aufgabe wird mit dem Cmdlet der Betrieb des Postfachservers und der zugehörigen Telefoniekomponenten getestet.
Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Auch wenn in diesem Thema alle Parameter für das Cmdlet aufgeführt werden, verfügen Sie möglicherweise nicht über den Zugriff auf einige Parameter, wenn sie nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Wie Sie herausfinden, welche Berechtigungen zur Ausführung eines bestimmten Cmdlets oder Parameters in Ihrer Organisation erforderlich sind, können Sie unter Find the permissions required to run any Exchange cmdlet nachlesen.
Beispiele
Beispiel 1
Test-UMConnectivity
In diesem Beispiel werden Verbindungs- und Betriebstests für den lokalen Postfachserver ausgeführt und dann VoIP-Verbindungsinformationen (Voice over IP) angezeigt.
Beispiel 2
Test-UMConnectivity -UMIPGateway MyUMIPGateway -Phone 56780 -Secured $false
In diesem Beispiel wird die Möglichkeit des lokalen Postfachservers getestet, eine nicht gesicherte TCP-Verbindung anstatt einer sicheren MTLS-Verbindung zu verwenden, um einen Anruf über das UM-IP-Gateway "MyUMIPGateway" unter Verwendung der Telefonnummer 56780 zu tätigen.
Beispiel 3
Test-UMConnectivity -Phone sip:sipdp.contoso.com@contoso.com -UMIPGateway MyUMIPGateway -Secured $true -From sip:user1@contoso.com -MediaSecured $true
In diesem Beispiel werden SIP-Wähleinstellungen durch Verwenden eines SIP-URI getestet. Dieses Beispiel kann in einer Umgebung verwendet werden, die Lync Server oder Skype for Business Server enthält.
Parameter
-CallRouter
Der CallRouter-Switch gibt an, ob der Microsoft Exchange Unified Messaging-Anrufrouterdienst (Front-End) getestet werden soll. Sie müssen keinen Wert für diese Option angeben.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016 |
-CertificateThumbprint
Der Parameter CertificateThumbprint gibt den Zertifikatfingerabdruck an, der für den Modus "SIP-gesichert" und "Gesichert" verwendet wird.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-Confirm
Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie diese Option sich auf das Cmdlet auswirkt, hängt davon ab, ob für die Option vor dem Fortfahren eine Bestätigung erforderlich ist.
- Destruktive Cmdlets (z. B. Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen:
-Confirm:$false
. - Die meisten anderen Cmdlets (z. B. New-* und Set-*-Cmdlets) verfügen nicht über eine integrierte Pause. Bei diesen Cmdlets führt das Angeben der Option "Confirm" ohne einen Wert eine Pause ein, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-DiagDtmfDurationInMilisecs
Der Parameter DiagDtmfDurationInMilisecs gibt die Dauer jeder gesendeten Ziffer an.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-DiagDtmfSequence
Der Parameter DiagDtmfSequence gibt die Reihenfolge der gesendeten Ziffern an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-DiagInitialSilenceInMilisecs
Der Parameter DiagInitialSilenceInMilisecs gibt den Zeitraum in Millisekunden an, für den das Cmdlet anhält, bevor die Ziffernfolge gesendet wird.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-DiagInterDtmfDiffGapInMilisecs
Der Parameter DiagInterDtmfDiffGapInMilisecs gibt an, ob die Zeit zwischen den Ziffern in der Diagnosereihenfolge angepasst wird. Dies ist eine durch Komma getrennte Liste, die Nulleinträge enthalten kann. Dies ist eine kommagetrennte Liste, die einen oder mehrere Nulleinträge enthalten kann.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-DiagInterDtmfGapInMilisecs
Der Parameter DiagInterDtmfGapInMilisecs gibt die Zeit in Millisekunden zwischen jeder Ziffer an, die in der Ziffernfolge gesendet wird. Hierbei handelt es sich um einen Einzelwert.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-DomainController
Der Parameter "DomainController" gibt den Domänencontroller an, der von diesem Cmdlet verwendet wird, um aus Active Directory Daten zu lesen oder hineinzuschreiben. Der Domänencontroller kann anhand seines vollqualifizierten Domänennamens (Fully Qualified Domain Name, FQDN) ermittelt werden. Beispiel: dc01.contoso.com.
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-From
Der From-Parameter gibt den SIP-URI oder die SIP-Adresse an, von der der Aufruf stammt. Sie wird nur verwendet, wenn Sie den Phone-Parameter verwenden. Die Standardeinstellung ist der SIP-URI, der bei Verwendung des Phone-Parameters angegeben wird.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-ListenPort
Der Parameter ListenPort gibt die Nummer des IP-Ports an, der überwacht werden soll. Erfolgt keine Angabe, wird IP-Port 9000 verwendet.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-MediaSecured
Der Parameter MediaSecured gibt an, ob Secure RTP oder der RTP-Modus (ungesicherter Modus) verwendet werden soll.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-MonitoringContext
Der Parameter MonitoringContext gibt an, ob zugehörige Überwachungsereignisse und Leistungsindikatoren in den Ergebnissen verwendet werden sollen. Gültige Werte sind:
- $true: Überwachungsereignisse und Leistungsindikatoren sind in den Befehlsergebnissen enthalten. In der Regel sind Überwachungsereignisse und Leistungsindikatoren in den Ergebnissen eingeschlossen, wenn die Ausgabe an den Microsoft System Center Operations Manager (SCOM) übergeben wird.
- $false: Überwachungsereignisse und Leistungsindikatoren sind nicht in den Befehlsergebnissen enthalten. Dies ist der Standardwert.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-Phone
Der Phone-Parameter gibt die Telefonnummer oder den SIP-URI (Uniform Resource Identifier) an, die verwendet werden, wenn der Testanruf umgeleitet wird. Die Durchwahlnummer sollte in der Nebenstellenanlage konfiguriert werden, um Aufrufe an die UM-Sammelsuche weiterzuleiten.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-PIN
Der Parameter PIN gibt die dem UM-aktivierten Postfach zugeordnete PIN an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-RemotePort
Der Parameter RemotePort gibt den für den Anruf zu verwendenden Port an. Wenn keine Angabe erfolgt, werden standardmäßig Port 5060 für TCP (Transmission Control Protocol) und Port 5061 für MTLS (Mutual Transport Layer Security) verwendet.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-ResetPIN
Der Parameter ResetPIN gibt an, ob eine neue PIN für alle Testpostfächer am aktuellen Standort generiert oder erneut generiert werden soll.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-Secured
Der Parameter Secured gibt an, ob der Test im Modus "SIP-gesichert" ausgeführt wird.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-Timeout
Der Parameter Timeout gibt an, wie lange (in Sekunden) auf den Abschluss des Testvorgangs gewartet wird. Der Standardwert beträgt 600 Sekunden. Sie können diesen Parameter nicht auf einen Wert von unter 60 Sekunden festlegen. Es wird jedoch empfohlen, diesen Parameter immer mit einem Wert von mindestens 60 Sekunden zu konfigurieren. Der Höchstwert für diesen Parameter ist 1.800 Sekunden.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-TUILogon
Der Parameter TUILogon gibt an, ob das Cmdlet versucht, sich an mindestens einem UM-aktivierten Postfach anzumelden. Die Postfächer müssen UM-fähig sein und dem UM-Wählplan zugeordnet sein, zu dem der Postfachserver gehört, auf dem der Microsoft Exchange Unified Messaging-Dienst ausgeführt wird. Die Standardeinstellung ist $false.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-TUILogonAll
Der TUILogonAll-Parameter gibt an, ob versucht werden soll, eine Verbindung mit allen Testpostfächern am aktuellen Active Directory-Standort herzustellen. Die Standardeinstellung ist $false. Die getesteten Konten müssen durch Aufrufen des Skripts "New-TestCasConnectivityUser.ps1" generiert werden, und die zugehörigen Postfächer müssen UM-aktiviert sein. Andernfalls werden keine Aktionen ausgeführt.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-UMDialPlan
Der Parameter UMDialPlan gibt die UM-Wähleinstellungen an, die getestet werden sollen. Dieser Parameter muss mit dem Parameter TUILogon verwendet werden.
Type: | UMDialPlanIdParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-UMIPGateway
Der Parameter UMIPGateway gibt den Namen des UM-IP-Gateways oder der IP-PBX-Ressource an, das bzw. die für den ausgehenden Testanruf verwendet wird.
Type: | UMIPGatewayIdParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-WhatIf
Die Option "WhatIf" simuliert die Aktionen des Befehls. Sie können diesen Switch verwenden, um die Änderungen anzuzeigen, die auftreten würden, ohne diese Änderungen tatsächlich anzuwenden. Sie müssen keinen Wert für diese Option angeben.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
Eingaben
Input types
Eingabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Eingabetyp für ein Cmdlet leer ist, akzeptiert das Cmdlet diese Eingabedaten nicht.
Ausgaben
Output types
Informationen zu den Rückgabetypen, die auch als Ausgabetypen bezeichnet werden, die dieses Cmdlet akzeptiert, finden Sie unter Cmdlet Input and Output Types. Wenn das Feld Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.