Set-TransportAgent
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Letztes Änderungsdatum des Themas: 2007-07-27
Mit dem Cmdlet Set-TransportAgent können Sie einen Transport-Agent auf einem Computer ändern, auf dem die Serverfunktion Edge-Transport oder Hub-Transport in einer Microsoft Exchange Server 2007-Organisation installiert ist.
Syntax
Set-TransportAgent -Identity <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Priority <Nullable>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Das Cmdlet Set-TransportAgent wird zum Ändern eines Transport-Agents auf einem Edge-Transport-Server oder einem Hub-Transport-Server verwendet.
Damit Sie das Cmdlet Set-TransportAgent ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:
- die Rolle Exchange-Serveradministrator und die Mitgliedschaft in der lokalen Gruppe Administratoren für den Zielserver
Um das Cmdlet Set-TransportAgent 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 Exchange 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
System.String |
Verwenden Sie diesen Parameter, um den Anzeigenamen des zu ändernden Transport-Agents anzuzeigen. Die Länge des Namens darf 64 Zeichen nicht überschreiten. |
Confirm |
Optional |
System.Management.Automation.SwitchParameter |
Der Parameter Confirm bewirkt eine Unterbrechung der Befehlsausführung und zwingt Sie, die Aktion des Befehls zu bestätigen, bevor die Verarbeitung fortgesetzt wird. Für den Parameter Confirm muss kein Wert angegeben werden. |
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
Um den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Domänencontrollers anzugeben, der diese Konfigurationsänderung in den Active Directory-Verzeichnisdienst schreibt, fügen Sie dem Befehl den Parameter DomainController hinzu. Der Parameter DomainController wird nicht auf Computern unterstützt, auf denen die Serverfunktion Edge-Transport ausgeführt wird. Die Serverfunktion Edge-Transport liest und schreibt nur in der lokalen ADAM-Instanz. |
Priority |
Optional |
System.Nullable |
Verwenden Sie diesen Parameter, um die Priorität des Transport-Agents anzugeben. Die Priorität des Transport-Agents steuert die Reihenfolge, in der die Transport-Agents E-Mail-Nachrichten verarbeiten. Die Priorität muss einen Wert zwischen 0 und der maximalen Anzahl von Transport-Agents besitzen. Das Standardverhalten besteht im Anfügen des neuen Transport-Agents am Ende der Prioritätenliste. Transport-Agents mit einer Priorität, die 0 am nächsten ist, verarbeiten E-Mail-Nachrichten zuerst. |
WhatIf |
Optional |
System.Management.Automation.SwitchParameter |
Der Parameter WhatIf weist den Befehl an, die für das Objekt ausgeführten Aktionen lediglich zu simulieren. Durch Verwendung des Parameters WhatIf können Sie eine Vorschau der Änderungen anzeigen, ohne diese Änderungen wirklich übernehmen zu müssen. Für den Parameter WhatIf muss kein Wert angegeben werden. |
Eingabetypen
Rückgabetypen
Fehler
| Fehler | Beschreibung |
|---|---|
|
Ausnahmen
| Ausnahmen | Beschreibung |
|---|---|
|
Beispiel
Das folgende Beispiel zeigt, wie die Priorität eines fiktiven Antiviren-Agents geändert wird.
Set-TransportAgent -Identity "Antivirus for Exchange" -Priority 3