Get-ReceiveConnector

  • Artikel

 

Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Letztes Änderungsdatum des Themas: 2007-06-28

Mit dem Cmdlet Get-ReceiveConnector können Sie die Konfigurationsinformationen für einen Empfangsconnector auf einem Computer anzeigen, auf dem die Serverfunktion Hub-Transport oder Edge-Transport installiert ist.

Syntax

Get-ReceiveConnector [-Identity <ReceiveConnectorIdParameter>] [-DomainController <Fqdn>]

Get-ReceiveConnector [-DomainController <Fqdn>] [-Server <ServerIdParameter>]

Detaillierte Beschreibung

Das Cmdlet Get-ReceiveConnector ruft die Konfigurationsinformationen für einen Empfangsconnector ab. Sie können den Parameter Identity verwenden, um die Konfigurationsinformationen für einen bestimmten Empfangsconnector abzurufen. Um die Konfigurationsinformationen für alle Empfangsconnectors abzurufen, geben Sie den Parameter Identity im Befehl nicht an. Sie können außerdem den Parameter Server zum Abrufen einer Liste aller auf einem bestimmten Computer konfigurierten Empfangsconnectors verwenden.

Damit Sie das Cmdlet Get-ReceiveConnector ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:

  • Exchange-Administratoren mit Leserechten (Rolle)

Um das Cmdlet Get-ReceiveConnector auf einem Computer ausführen zu können, auf dem die Serverfunktion Edge-Transport installiert ist, müssen Sie sich mit einem Konto anmelden, das Mitglied der lokalen Gruppe Administratoren auf diesem Computer ist.

Weitere Informationen zu Berechtigungen, zum Delegieren von Rollen und zu den Rechten, die für die Verwaltung von Microsoft Exchange Server 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

Microsoft.Exchange.Configuration.Tasks.ReceiveConnectorIdParameter

Verwenden Sie den Parameter Identity, um die GUID oder den Connectornamen anzugeben, die bzw. der einen bestimmten Empfangsconnector darstellt. Sie können den Servernamen auch einschließen, indem Sie das Format Servername\Connectorname verwenden.

Die Bezeichnung des Parameters Identity kann ausgelassen werden, so dass nur der Connectorname oder seine GUID angegeben wird.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

Um den vollqualifizierten Domänennamen des Domänencontrollers anzugeben, der Daten aus dem Active Directory-Verzeichnisserver abruft, fügen Sie dem Befehl den Parameter DomainController hinzu. Der Parameter DomainController wird nicht auf Computern unterstützt, auf denen die Serverfunktion Edge-Transport installiert ist. Die Serverfunktion Edge-Transport schreibt und liest nur in der lokalen ADAM-Instanz (Active Directory Application Mode).

Server

Optional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Mit dem Parameter Server können Sie den Namen des Servers angeben, der beim Ausführen des Befehls abgefragt werden soll. Nur die auf den angegebenen Server konfigurierten Empfangsconnectors werden angezeigt.

Eingabetypen

Rückgabetypen

Fehler

Fehler Beschreibung

 

 

Beispiel

Das folgende Codebeispiel zeigt drei Beispiele, die das Cmdlet Get-ReceiveConnector verwenden.

Der erste Befehl zeigt eine Übersichtsliste aller Empfangsconnectors auf allen Hub-Transport-Servern oder auf dem lokalen Edge-Transport-Server an, auf dem der Befehl ausgeführt wird.

Im zweiten Beispiel wird gezeigt, wie die Detailkonfiguration eines bestimmten Empfangsconnectors durch Umleiten der Ergebnisse des Cmdlets Get-ReceiveConnector mittels Piping an das Cmdlet Format-List angezeigt wird.

Im dritten Beispiel wird gezeigt, wie Sie eine Übersichtsliste der auf einem bestimmten Server konfigurierten Empfangsconnectors anzeigen.

Weitere Informationen zum Pipelining finden Sie unter Pipelining.

Weitere Informationen zum Arbeiten mit der Ausgabe einer Cmdlets finden Sie unter Arbeiten mit Ausgaben von Befehlen.

Get-ReceiveConnector 
Get-ReceiveConnector "Receive Connector Name" | Format-List
Get-ReceiveConnector -Server Hub1