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