Freigeben über

Test-PowerShellConnectivity

Modul:
Exchange PowerShell

Dieses Cmdlet ist nur lokal in Exchange verfügbar.

Verwenden Sie das Cmdlet Test-PowerShellConnectivity, um die Clientkonnektivität mit virtuellen Exchange-Remote-PowerShell-Verzeichnissen zu testen.

Hinweis: Dieses Cmdlet funktioniert am besten in Exchange 2010. In höheren Versionen von Exchange wird 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

URL 

Test-PowerShellConnectivity
    -ConnectionUri <Uri>
    -TestCredential <PSCredential>
    [-Authentication <AuthenticationMethod>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-MailboxServer <ServerIdParameter>]
    [-MonitoringContext]
    [-ResetTestAccountCredentials]
    [-TrustAnySSLCertificate]
    [-WhatIf]
    [<CommonParameters>]

Identity 

Test-PowerShellConnectivity
    [[-ClientAccessServer] <ServerIdParameter>]
    [-TestType <OwaConnectivityTestType>]
    [-VirtualDirectoryName <String>]
    [-Authentication <AuthenticationMethod>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-MailboxServer <ServerIdParameter>]
    [-MonitoringContext]
    [-ResetTestAccountCredentials]
    [-TrustAnySSLCertificate]
    [-WhatIf]
    [<CommonParameters>]

Beschreibung

Das cmdlet Test-PowerShellConnectivity testet die Exchange-Remote-PowerShell-Konnektivität durch Herstellen einer Verbindung mit einem angegebenen virtuellen PowerShell-Remoteverzeichnis, mit virtuellen PowerShell-Remoteverzeichnissen auf einem angegebenen Exchange-Server oder mit virtuellen PowerShell-Remoteverzeichnissen, die am lokalen Active Directory-Standort verfügbar sind.

Wenn Sie das Cmdlet erstmalig verwenden, müssen Sie möglicherweise einen Testbenutzer erstellen. Führen Sie den folgenden Befehl aus, um einen Testbenutzer zu erstellen:

& $env:ExchangeInstallPath\Scripts\New-TestCasConnectivityUser.ps1

Die Testergebnisse werden auf dem Bildschirm angezeigt. Das Cmdlet gibt folgende Informationen zurück.

  • CasServer: Der Exchange-Server, mit dem der Client verbunden ist.
  • LocalSite: Der Name des lokalen Active Directory-Standorts.
  • Szenario: Die Vorgänge, die getestet werden. Die folgenden Werte sind vorhanden: Logon User.
  • Resultat: Die zurückgegebenen Werte sind normalerweise „Erfolg“, „Übersprungen“ oder „Fehlgeschlagen“.
  • Latenz (ms): Die erforderliche Zeit zum Abschließen des Tests in Millisekunden.
  • Fehler: Fehlermeldungen, die aufgetreten sind.

Sie können die Ergebnisse in eine Datei schreiben, indem Sie die Ausgabe an ConvertTo-Html und Set-Content weiterleiten. Beispiel: Test-PowerShellConnectivity -ClientAccessServer MBX01 | ConvertTo-Html | Set-Content -Path "C:\My Documents\PowerShell Test.html".

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Obwohl in diesem Artikel alle Parameter für das Cmdlet aufgeführt sind, haben Sie möglicherweise keinen 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-PowerShellConnectivity -ClientAccessServer MBX2 -VirtualDirectoryName "PowerShell (Default Web Site)" -TrustAnySSLCertificate

In diesem Beispiel wird das virtuelle PowerShell-Verzeichnis (Standardwebsite) auf dem Server "MBX2" getestet. Die Option TrustAnySSLCertificate wird verwendet, um die Zertifikatsüberprüfung während der Verbindung zu überspringen.

Beispiel 2

$UserCredentials = Get-Credential

Test-PowerShellConnectivity -ConnectionUri https://contoso.com/powershell -TestCredential $UserCredentials -Authentication Basic

In diesem Beispiel wird das virtuelle Remoteverzeichnis von PowerShell getestet, das unter https://contoso.com/powershellverfügbar ist. Es wird kein Konflikt zwischen dem SSL-Zertifikat und der URL erwartet, daher wird der Switch TrustAnySSLCertificate nicht verwendet. Das virtuelle Verzeichnis ist für die Verwendung der grundlegenden Authentifizierung konfiguriert.

Die zum Herstellen der Verbindung zum virtuellen Verzeichnis verwendeten Anmeldeinformationen werden in der Variable $UserCredentials gespeichert. Der Test wird anschließend wie zuvor beschrieben ausgeführt.

Parameter

-Authentication

Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Der Parameter Authentication gibt die Art der Authentifizierung an, die für die Verbindung verwendet wird. Gültige Werte sind:

  • Default
  • Standard
  • Credssp
  • Digest
  • Kerberos
  • Verhandeln

Parametereigenschaften

Typ:AuthenticationMethod
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ClientAccessServer

Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Der Parameter ClientAccessServer gibt den zu testenden Exchange-Server an. Auf diesem Server ist die Clientzugriffs-Serverrolle installiert, und er ist verantwortlich für das Akzeptieren von Clientverbindungen.

Der Parameter MailboxServer gibt den zu testenden exExchange2k16- oder exExchange2k13-Postfachserver an. Beispiel:

  • Name
  • Distinguished Name (DN)
  • ExchangeLegacyDN
  • GUID

Verwenden Sie diesen Parameter nicht zusammen mit dem Parameter ConnectionUri.

Parametereigenschaften

Typ:ServerIdParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Identity
Position:1
Obligatorisch.:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Confirm

Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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 (beispielsweise Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen: -Confirm:$false.
  • Die meisten anderen Cmdlets (beispielsweise 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.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ConnectionUri

Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Der Parameter ConnectionUri gibt die URL des zu testenden virtuellen PowerShell-Remoteverzeichnisses an, z. B https://contoso.com/powershell. .

Verwenden Sie diesen Parameter nicht zusammen mit dem Parameter ClientAccessServer.

Parametereigenschaften

Typ:Uri
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

URL
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DomainController

Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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.

Parametereigenschaften

Typ:Fqdn
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-MailboxServer

Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Der Parameter MailboxServer gibt den Exchange-Postfachserver an, den Sie testen möchten. Dieser Parameter identifiziert den Back-End-Server, der Proxyverbindungen vom Front-End-Server akzeptiert, wo die Clients eine Verbindung herstellen.

Der Parameter MailboxServer gibt den zu testenden exExchange2k16- oder exExchange2k13-Postfachserver an. Beispiel:

  • Name
  • Distinguished Name (DN)
  • ExchangeLegacyDN
  • GUID

Wenn Sie diesen Parameter nicht verwenden, werden die Verbindungen zu allen Postfachservern im lokalen Active Directory-Standort getestet.

Parametereigenschaften

Typ:ServerIdParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-MonitoringContext

Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Die Option MonitoringContext schließt die zugeordneten Überwachungsereignisse und Leistungsindikatoren in die Ergebnisse ein. Sie müssen keinen Wert für diese Option angeben.

In der Regel sind Überwachungsereignisse und Leistungsindikatoren in den Ergebnissen eingeschlossen, wenn die Ausgabe an den Microsoft System Center Operations Manager (SCOM) übergeben wird.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ResetTestAccountCredentials

Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Der Parameter ResetTestAccountCredentials setzt das Kennwort für das Testkonto zurück, das zur Ausführung dieses Befehls verwendet wird. Sie müssen keinen Wert für diese Option angeben.

Das Kennwort für das Testkonto wird normalerweise alle 7 Tage zurückgesetzt. Verwenden Sie diese Option, um das Zurücksetzen eines Kennworts immer dann zu erzwingen, wenn dies aus Sicherheitsgründen notwendig ist.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-TestCredential

Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Der Parameter TestCredential gibt die Anmeldeinformationen für den Test an.

Ein Wert für diesen Parameter setzt das Cmdlet "Get-Credential" voraus. Verwenden Sie den Wert (Get-Credential), um diesen Befehl anzuhalten und eine Aufforderung zur Eingabe von Anmeldeinformationen zu erhalten. Oder speichern Sie die Anmeldeinformationen in einer Variablen (beispielsweise $cred = Get-Credential), bevor Sie diesen Befehl ausführen, und verwenden Sie dann den Variablennamen ($cred) für diesen Parameter. Weitere Informationen finden Sie unter Get-Credential.

Sie können diesen Parameter nur mit dem ConnectionUri-Parameter verwenden.

Parametereigenschaften

Typ:PSCredential
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

URL
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-TestType

Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Der Parameter TestType gibt an, ob der Befehl interne oder externen URLs testet. Gültige Werte sind Internal und External. Der Standardwert lautet Internal.

Sie können nur diesen Parameter zusammen mit dem Parameter ClientAccessServer verwenden.

Parametereigenschaften

Typ:OwaConnectivityTestType
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Identity
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-TrustAnySSLCertificate

Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Mit dem Schalter TrustAnySSLCertificate kann Exchange Zertifikate von nicht vertrauenswürdigen Zertifizierungsstellen (Certification Authorities, CAs) akzeptieren. Sie müssen keinen Wert für diese Option angeben.

Der Switch TrustAnySSLCertificate gibt an, ob SSL-Zertifikatsüberprüfungsfehler ignoriert werden sollen. Sie müssen keinen Wert für diese Option angeben.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VirtualDirectoryName

Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Der Parameter VirtualDirectoryName gibt den Namen des virtuellen Remote-PowerShell-Verzeichnisses an, das getestet werden soll. Setzen Sie Werte, die Leerzeichen enthalten, in Anführungszeichen (").

Sie können nur diesen Parameter zusammen mit dem Parameter ClientAccessServer verwenden. Wenn Sie diesen Parameter nicht verwenden, werden alle verfügbaren virtuellen Remote-PowerShell-Verzeichnisse auf dem Server getestet.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Identity
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WhatIf

Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.

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 und die von diesem Cmdlet akzeptiert werden, finden Sie unter Eingabe- und Ausgabetypen von Cmdlets. Wenn das Feld mit dem Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.