Condividi tramite


Set-TransportAgent

 

Si applica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Ultima modifica dell'argomento: 2007-07-27

Utilizzare il cmdlet Set-TransportAgent per modificare un agente di trasporto su un computer in cui è installato il nuovo ruolo del server Trasporto Edge o Trasporto Hub in un'organizzazione di Microsoft Exchange Server 2007.

Sintassi

Set-TransportAgent -Identity <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Priority <Nullable>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Il cmdlet Set-TransportAgent viene utilizzato per modificare un agente di trasporto in un server Trasporto Edge o Trasporto Hub.

Per eseguire il cmdlet Set-TransportAgent, è necessario utilizzare un account che disponga della seguente delega:

  • Ruolo Exchange Server Administrator e gruppo Administrators locale del server di destinazione

Per eseguire il cmdlet Set-TransportAgent su un computer in cui è installato il ruolo del server Trasporto Edge, è necessario accedere al sistema utilizzando un account che sia membro del gruppo Administrators locale del computer.

Per ulteriori informazioni sulle autorizzazioni, sulla delega dei ruoli e sui diritti necessari per l'amministrazione di Exchange 2007, vedere Considerazioni sulle autorizzazioni.

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

System.String

Utilizzare questo parametro per specificare il nome visualizzato dell'agente di trasporto da modificare. La lunghezza del nome non può superare i 64 caratteri.

Confirm

Facoltativo

System.Management.Automation.SwitchParameter

Il parametro Confirm consente di determinare la sospensione dell'elaborazione e di richiedere che l'utente confermi l'operazione che verrà eseguita dal comando prima che l'elaborazione continui. Con il parametro Confirm non è necessario specificare un valore.

DomainController

Facoltativo

Microsoft.Exchange.Data.Fqdn

Per specificare il nome di dominio completo (FQDN) del controller di dominio che consente di scrivere la modifica alla configurazione nel servizio directory di Active Directory, includere nel comando il parametro DomainController. Il parametro DomainController non è supportato nei computer che eseguono il ruolo del server Trasporto Edge. Il ruolo del server Trasporto Edge consente di leggere e scrivere solo nell'istanza locale ADAM.

Priority

Facoltativo

System.Nullable

Utilizzare questo parametro per specificare la priorità dell'agente di trasporto. La priorità dell'agente di trasporto controlla l'ordine in cui gli agenti di trasporto elaborano i messaggi di posta. La priorità deve avere un valore compreso tra 0 e il numero massimo degli agenti di trasporto. Per impostazione predefinita viene aggiunto un nuovo agente di trasporto alla fine dell'elenco delle priorità. Gli agenti di trasporto con la priorità più vicina a 0 elaborano per primi i messaggi.

WhatIf

Facoltativo

System.Management.Automation.SwitchParameter

Il parametro WhatIf consente di indicare al comando di simulare le azioni da eseguire sull'oggetto. Il parametro WhatIf consente di visualizzare le modifiche che verrebbero apportate senza applicarle. Con il parametro WhatIf non è necessario specificare un valore.

Tipi di input

Tipi restituiti

Errori

Errore Descrizione

 

Eccezioni

Eccezioni Descrizione

 

Esempio

Nel seguente esempio viene descritta la modalità di modifica della priorità di un agente antivirus fittizio.

Set-TransportAgent -Identity "Antivirus for Exchange" -Priority 3