Set-TransportRule (RTM)
Si applica a: Exchange Server 2007
Ultima modifica dell'argomento: 2007-06-08
Utilizzare il cmdlet Set-TransportRule per modificare una regola di trasporto esistente utilizzata dall'agente Regole di trasporto per elaborare i messaggi di posta elettronica inviati tramite un computer in cui è installato il ruolo server Trasporto Hub o Trasporto Edge.
Sintassi
Set-TransportRule -Identity <RuleIdParameter> [-Actions <TransportRuleAction[]>] [-Comments <String>] [-Conditions <TransportRulePredicate[]>] [-DomainController <Fqdn>] [-Exceptions <TransportRulePredicate[]>] [-Name <String>] [-Priority <Int32>]
Set-TransportRule [-Actions <TransportRuleAction[]>] [-Comments <String>] [-Conditions <TransportRulePredicate[]>] [-DomainController <Fqdn>] [-Exceptions <TransportRulePredicate[]>] [-Instance <Rule>] [-Name <String>] [-Priority <Int32>]
Descrizione dettagliata
Il cmdlet Set-TransportRule consente di modificare una regola di trasporto esistente utilizzata dall'agente Regole di trasporto per elaborare i messaggi di posta elettronica inviati tramite un server Trasporto Hub o Trasporto Edge.
Ciascuna condizione ed eccezione deve utilizzare un predicato della regola di trasporto supportato. Ciascun predicato è composto da almeno una condizione e dai relativi valori.
Per un elenco dei predicati supportati delle regole di trasporto, vedere Predicati delle regole di trasporto.
Ciascuna azione deve utilizzare un'azione di regola di trasporto supportata. Ciascuna azione è composta da almeno un'azione e dai valori che l'azione utilizza per eseguire le proprie attività.
Per ottenere un elenco delle azioni delle regole supportate, vedere Azioni delle regole di trasporto.
Per informazioni dettagliate su come modificare una regola di trasporto esistente, vedere Come modificare una regola di trasporto.
Per informazioni sull'agente Regole di trasporto, vedere Cenni preliminari sulle regole di trasporto.
Per eseguire il cmdlet Set-TransportRule, è necessario utilizzare un account che disponga della seguente delega:
- Ruolo Exchange Organization Administrator
Per eseguire il cmdlet Set-TransportRule su un computer in cui è installato il ruolo 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 Server 2007, vedere Considerazioni sulle autorizzazioni.
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Obbligatorio |
Microsoft.Exchange.MessagingPolicies.Rules.Tasks.RuleIdParameter |
Utilizzare questo parametro per specificare il GUID della regola di trasporto o il nome della regola configurata dall'amministratore durante la creazione della regola. |
Actions |
Facoltativo |
Microsoft.Exchange.MessagingPolicies.Rules.Tasks.TransportRuleAction[] |
Utilizzare questo parametro per specificare le azioni applicate dalla regola di trasporto al messaggio di posta elettronica quando sono soddisfatte tutte le condizioni e in assenza di eccezioni. È necessario specificare almeno un'azione per ciascuna regola. |
Comments |
Facoltativo |
System.String |
Utilizzare questo parametro per aggiungere commenti informativi alla regola di trasporto, ad esempio per cosa viene utilizzata la regola o come è cambiata nel tempo. La lunghezza del commento non può superare i 512 caratteri. |
Conditions |
Facoltativo |
Microsoft.Exchange.MessagingPolicies.Rules.Tasks.TransportRulePredicate[] |
Utilizzare questo parametro per specificare le condizioni applicate dalla regola di trasporto ai messaggi di posta elettronica inviati all'agente Regole di trasporto. Se non si configura una condizione in una regola, la regola verrà applicata a tutti i messaggi se nessuna eccezione è associata. |
DomainController |
Facoltativo |
Microsoft.Exchange.Data.Fqdn |
Per specificare il nome di dominio completo (FQDN) del controller di dominio che consente di recuperare i dati da Active Directory, includere nel comando il parametro DomainController. Il parametro DomainController non è supportato nei computer che eseguono il ruolo del server Edge Transport. Il ruolo del server Edge Transport prevede solo la scrittura nell'istanza locale Active Directory Application Mode (ADAM). |
Eccezioni |
Facoltativo |
Microsoft.Exchange.MessagingPolicies.Rules.Tasks.TransportRulePredicate[] |
Utilizzare questo parametro per specificare le eccezioni applicate dalla regola di trasporto al messaggio di posta elettronica. Se un messaggio corrisponde a un'eccezione, non viene applicata alcuna azione specificata in questa regola al messaggio. |
Instance |
Facoltativo |
Microsoft.Exchange.MessagingPolicies.Rules.Tasks.Rule |
Utilizzare questo parametro per inviare un intero oggetto al comando da elaborare. Questo parametro viene utilizzato principalmente negli script in cui è necessario passare l'intero oggetto al comando. |
Nome |
Facoltativo |
System.String |
Utilizzare questo parametro per specificare il nome visualizzato della regola di trasporto da creare. La lunghezza del nome non può superare i 64 caratteri. |
Priorità |
Facoltativo |
System.Int32 |
Utilizzare questo parametro per specificare l'ordine in cui vengono applicate le regole di trasporto. Se si modifica la priorità della regola, la posizione della regola all'interno dell'elenco delle regole viene modificata per assegnare la priorità specificata. L'agente Regole di trasporto incrementa quindi tutte le regole il cui valore di priorità è più elevato. Le regole con un valore di priorità inferiore vengono elaborate per prime. Il valore di questo parametro deve essere maggiore di o uguale a 0. |
Tipi di input
Tipi restituiti
Errori
| Errore | Descrizione |
|---|---|
|
|
Eccezioni
| Eccezioni | Descrizione |
|---|---|
|
|
Esempio
Di seguito viene riportato un esempio completo che mostra come modificare una regola di trasporto esistente in un server Hub Transport. In questo esempio viene mostrato come modificare le condizioni di una regola di trasporto senza influire sulle eccezioni o sulle azioni nella stessa regola.
Questa regola sarà modificata per applicare la seguente condizione:
- da un membro di lista di distribuzione Il valore di questa condizione è il gruppo di distribuzione "Gruppo vendite".
$Condition = Get-TransportRulePredicate FromMemberOf
$Condition.Addresses = @((Get-DistributionGroup "Sales Group"))
Set-TransportRule "Sales-Brokerage Wall" -Condition @($condition)