Condividi tramite


Set-TransportRule

 

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-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[]>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Exceptions <TransportRulePredicate[]>] [-Name <String>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]]

Set-TransportRule [-Actions <TransportRuleAction[]>] [-Comments <String>] [-Conditions <TransportRulePredicate[]>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Exceptions <TransportRulePredicate[]>] [-Instance <Rule>] [-Name <String>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]]

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 di regole di trasporto supportati, 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 Microsoft 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 che la regola di trasporto applica al messaggio di posta elettronica se sono soddisfatte tutte le condizioni e se non vengono rilevate 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 inoltrati all'agente Regole di trasporto. Se non si configura una condizione in una regola, la regola sarà applicata a tutti i messaggi se non vengono rilevate eccezioni.

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 recupera i dati da Active Directory, includere il parametro DomainController nel comando. 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).

Exceptions

Facoltativo

Microsoft.Exchange.MessagingPolicies.Rules.Tasks.TransportRulePredicate[]

Utilizzare questo parametro per specificare le eccezioni che la regola di trasporto applica 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.

Name

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.

Priority

Facoltativo

System.Int32

Utilizzare questo parametro per specificare l'ordine di applicazione delle regole di trasporto. Se si modifica la priorità della regola, la posizione della regola nell'elenco cambia in base alla priorità specificata e l'agente Regole di trasporto incrementa tutte le regole con un 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.

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

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)