New-TransportRule
Si applica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Ultima modifica dell'argomento: 2007-08-13
Il cmdlet New-TransportRule consente di creare una nuova regola di trasporto utilizzata dall'agente regole di trasporto durante l'elaborazione dei messaggi di posta elettronica che transitano in un computer in cui è installato il ruolo del server Trasporto Hub o il ruolo del server Trasporto Edge di Microsoft Exchange Server 2007.
Sintassi
New-TransportRule -Name <String> -Actions <TransportRuleAction[]> [-Comments <String>] [-Conditions <TransportRulePredicate[]>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-Exceptions <TransportRulePredicate[]>] [-Priority <Int32>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Il cmdlet New-TransportRule consente di creare una nuova regola di trasporto utilizzata dall'agente regole di trasporto durante l'elaborazione dei messaggi di posta elettronica che transitano in un server Trasporto Hub o in un server Trasporto Edge in un'organizzazione di Exchange 2007.
Ogni condizione e ogni eccezione deve utilizzare un predicato della regola di trasporto supportato. Ogni predicato consiste del predicato stesso e del valore che deve essere verificato.
Per un elenco dei predicati supportati delle regole di trasporto, vedere Predicati delle regole di trasporto.
Ogni azione deve utilizzare un'azione della regola supportata. Ogni azione consiste dell'azione stessa e dei valori che l'azione utilizza per eseguire la sua attività.
Per un elenco delle azioni delle regole di trasporto supportate, vedere Azioni delle regole di trasporto.
Per informazioni dettagliate su come creare una nuova regola di trasporto, vedere Come creare una nuova regola di trasporto.
Per informazioni sull'agente Regole di trasporto, vedere Cenni preliminari sulle regole di trasporto.
Per eseguire il cmdlet New-TransportRule, è necessario utilizzare un account che disponga della seguente delega:
- Ruolo Exchange Organization Administrator
Per eseguire il cmdlet New-TransportRule 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 |
|---|---|---|---|
Actions |
Obbligatorio |
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. |
Name |
Obbligatorio |
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. |
Comments |
Facoltativo |
System.String |
Utilizzare questo parametro per aggiungere commenti alla regola, quali ad esempio l'utilizzo o le modifiche apportate nel corso del tempo. La lunghezza del commento non può superare i 1024 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. |
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, fully qualified domain name) del controller di dominio che consente di recuperare i dati dal servizio directory di 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). |
Enabled |
Facoltativo |
System.Boolean |
Utilizzare questo parametro per specificare se abilitare o disabilitare la regola di trasporto dopo che è stata creata. Il valore predefinito è |
Exceptions |
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 è associato a un'eccezione, nessuna azione specificata in questa regola viene applicata al messaggio. |
Priority |
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 il cui valore di priorità è più basso vengono elaborate per prime. Il valore di questo parametro deve essere maggiore di o uguale a 0. |
TemplateInstance |
Facoltativo |
System.Management.Automation.PSObject |
Quando per questo parametro viene specificato un oggetto esistente, il comando utilizza la configurazione dell'oggetto per creare un oggetto duplicato in un server locale o di destinazione. Per ulteriori informazioni, vedere Modelli. |
WhatIf |
Facoltativo |
System.Management.Automation.SwitchParameter |
Il parametro WhatIf consente al comando di simulare le azioni da intraprendere 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 descritto come creare una nuova regola di trasporto in un server Hub Transport.
Questa regola applica le seguenti condizioni:
- tra liste di distribuzione Il primo valore della proprietà del predicato per questa condizione è il gruppo di distribuzione delle vendite. Il secondo valore della proprietà del predicato per questa condizione è il gruppo di distribuzione di intermediazione.
Vengono applicate le seguenti eccezioni:
con schemi di testo nell'oggetto Il valore di questa eccezione è "Comunicato stampa" o "Comunicazione aziendale".
dagli utenti I valori di questa eccezione sono gli utenti Ted Bremer e Pilar Ackerman.
Le seguenti azioni verranno applicate ai messaggi associati alle condizioni descritte in precedenza, ma che non sono associati alle eccezioni "con schemi di testo nell'oggetto" o "dagli utenti":
invia messaggio restituito al mittente Il valore per questa azione è "I messaggi di posta inviati tra il reparto vendite e il reparto intermediazione non sono consentiti".
registra evento con messaggio Il valore per questa azione è "È stato rifiutato un messaggio di posta elettronica non consentito."
$Condition1 = Get-TransportRulePredicate BetweenMemberOf
$Condition1.Addresses = @((Get-DistributionGroup "Sales Group"))
$Condition1.Addresses2 = @((Get-DistributionGroup "Brokerage Group"))
$Exception1 = GetTransportRulePredicate From
$Exception1.Addresses = @((Get-MailUser "Ted Bremer"), (Get-MailUser "Pilar Ackerman"))
$Exception2 = Get-TransportRulePredicate SubjectContains
$Exception2.Words = @("Press Release", "Corporate Communication")
$Action1 = Get-TransportRuleAction RejectMessage
$Action1.RejectReason = "E-mail messages sent between the Sales department and the Brokerage department are prohibited."
$Action2 = Get-TransportRuleAction LogEvent
$Action2.EventMessage = "A prohibited e-mail message has been rejected."
New-TransportRule -name "Block e-mail messages between Sales and Brokerage groups" -Condition @($Condition1) -Exception @($Exception1, $Exception2) -Action @($Action1, $Action2)