Gestione degli agenti di trasporto
Si applica a: Exchange Server 2013
Gli agenti di trasporto utilizzano gli eventi SMTP per eseguire operazioni sui messaggi durante il passaggio nella pipeline di trasporto. La maggior parte degli agenti di trasporto predefiniti inclusi in Microsoft Exchange Server 2013 sono invisibili e non gestibili. Tuttavia, è possibile installare e configurare agenti di trasporto di terze parti nei server Exchange dell'organizzazione. Per ulteriori informazioni sugli agenti di trasporto, vedere Agenti di trasporto.
Che cosa è necessario sapere prima di iniziare?
Tempo stimato per il completamento di ciascuna procedura: 10 minuti
Per eseguire queste procedure, è necessario disporre delle autorizzazioni appropriate. Per sapere quali autorizzazioni sono necessarie, vedere "Agenti di trasporto" nell'argomento Autorizzazioni per il flusso di posta.
È possibile utilizzare solo Shell per eseguire questa procedura.
Il supporto per agenti di trasporto legacy non è abilitato per impostazione predefinita, tuttavia è possibile abilitarlo. Per istruzioni, vedere Attivare il supporto per gli agenti di trasporto legacy.
Per informazioni sui tasti di scelta rapida che è possibile utilizzare con le procedure in questo argomento, vedere Tasti di scelta rapida nell'interfaccia di amministrazione di Exchange.
Consiglio
Problemi? È possibile richiedere supporto nei forum di Exchange. Visitare i forum all'indirizzo Exchange Server.
Informazioni sulle procedure per gli agenti di trasporto nel servizio di trasporto front-end sui server Accesso client
Non è possibile utilizzare Exchange Management Shell per gestire l'agente di trasporto nel servizio di trasporto front-end su un server Accesso client. È necessario invece aprire Windows PowerShell sul server Accesso client e importare i cmdlet di Exchange nella sessione Windows PowerShell.
Avviso
L'esecuzione di cmdlet di Exchange in Windows PowerShell per attività diverse dalla gestione degli agenti di trasporto nel servizio di trasporto front-end non è supportata. Potrebbero verificarsi gravi conseguenza se si ignora Exchange Management Shell e il controllo dell'accesso basato sui ruoli (RBAC) eseguendo i cmdlet Exchange in Windows PowerShell. È sempre consigliabile eseguire i cmdlet di Exchange in Exchange Management Shell. Per ulteriori informazioni, vedere Note sulla versione di Exchange 2013.
Per eseguire una o più procedure dell'agente di trasporto descritte in questo argomento nel servizio di trasporto front-end, è necessario effettuare i seguenti passaggi aggiuntivi:
Sul server Accesso client aprire Windows PowerShell ed eseguire il comando riportato di seguito:
Add-PSSnapin Microsoft.Exchange.Management.PowerShell.SnapIn
Eseguire il comando come descritto, ma aggiungere il valore seguente al comando:
-TransportService FrontEnd
.Ad esempio, per visualizzare gli agenti di trasporto nel servizio di trasporto front-end su un server Accesso client, eseguire il comando riportato di seguito:
Get-TransportAgent -TransportService FrontEnd
Installazione di un agente di trasporto tramite Shell
Quando si installa un agente di trasporto, Exchange registra solamente le DLL associate all'agente di trasporto. Verificare che tutti i file, le chiavi di registro e gli altri oggetti da cui l'agente di trasporto dipende siano installati e configurati correttamente. Una volta caricate le DLL, Exchange continuerà a fare riferimento alle DLL dopo il completamento del comando.
Gli agenti di trasporto dispongono dell'accesso completo a tutti i messaggi di posta elettronica rilevati. In Exchange non sono previste limitazioni sul comportamento di un agente di trasporto. Gli agenti di trasporto instabili o contenenti difetti nel sistema di protezione possono incidere sulla stabilità e sulla protezione di Exchange. Pertanto, è necessario installare soltanto gli agenti di trasporto completamente attendibili e già sperimentati in un ambiente di prova.
Gli agenti di trasporto vengono installati in stato disabilitato, per garantire che il flusso di posta non venga influenzato dagli agenti di trasporto non ancora configurati. Pertanto, dopo aver configurato correttamente un agente di trasporto, è necessario abilitarlo.
Per installare un agente di trasporto, utilizzare la seguente sintassi.
Install-TransportAgent -Name <TransportAgentIdentity> -TransportAgentFactory <"TransportAgentFactory"> -AssemblyPath <"FilePath">
In questo esempio viene installato un agente di trasporto fittizio denominato Contoso Transport Agent nel servizio di trasporto su un server Cassette postali.
Install-TransportAgent -Name "Contoso Transport Agent" -TransportAgentFactory "vendor.exchange.ContosoTransportAgentfactory" -AssemblyPath "C:\Program Files\Vendor\TransportAgent\ContosoTransportAgentFactory.dll"
Come verificare se l'operazione ha avuto esito positivo
Per verificare che l'agente di trasporto sia stato installato correttamente, eseguire il comando Get-TransportAgent
e verificare che l'agente di trasporto sia elencato.
Abilitazione di un agente di trasporto tramite Shell
Per abilitare un agente di trasporto, utilizzare la seguente sintassi.
Enable-TransportAgent <TransportAgentIdentity>
In questo esempio viene abilitato l'agente di trasporto fittizio denominato Contoso Transport Agent nel servizio di trasporto su un server Cassette postali.
Enable-TransportAgent "Contoso Transport Agent"
Come verificare se l'operazione ha avuto esito positivo
Per verificare di aver abilitato correttamente un agente di trasporto, eseguire il comando Get-TransportAgent | Format-List Name,Enabled
e verificare che l'agente di trasporto sia abilitato.
Disabilitazione di un agente di trasporto tramite Shell
Per disabilitare un agente di trasporto, utilizzare la seguente sintassi.
Disable-TransportAgent <TransportAgentIdentity>
In questo esempio viene disabilitato l'agente di trasporto denominato Fabrikam Transport Agent nel servizio di trasporto su un server Cassette postali.
Disable-TransportAgent "Fabrikam Transport Agent"
Come verificare se l'operazione ha avuto esito positivo
Per verificare che un agente di trasporto sia stato disabilitato correttamente, eseguire il comando Get-TransportAgent | Format-List Name,Enabled
e verificare che l'agente di trasporto sia disabilitato.
Visualizzazione degli agenti di trasporto tramite Shell
Per visualizzare un elenco di riepilogo di tutti gli agenti di trasporto, eseguire il comando riportato di seguito:
Get-TransportAgent
Per visualizzare la configurazione dettagliata per un agente di trasporto specifico, eseguire il comando riportato di seguito:
Get-TransportAgent <TransportAgentIdentity> | Format-List
In questo esempio viene fornita la configurazione dettagliata dell'agente di trasporto denominato Transport Rule Agent.
Get-TransportAgent "Transport Rule Agent" | Format-List
Configurazione della priorità di un agente di trasporto tramite Shell
Gli agenti di trasporto con la priorità più vicina a 0 elaborano per primi i messaggi di posta elettronica. Tuttavia, a causa dell'evento SMTP nella pipeline di trasporto in cui è registrato l'agente, sul messaggio potrebbe agire prima un agente con priorità più bassa, anziché un agente con priorità più alta.
Per modificare la priorità di un agente di trasporto esistente, utilizzare il comando riportato di seguito.
Set-TransportAgent <TransportAgentIdentity> -Priority <Integer>
In questo esempio viene impostato il valore 3 per la priorità dell'agente relativa all'agente di trasporto Contoso Transport Agent nel servizio di trasporto su un server Cassette postali.
Set-TransportAgent "Contoso Transport Agent" -Priority 3
Come verificare se l'operazione ha avuto esito positivo
Per verificare di aver configurato correttamente la priorità di un agente di trasporto, eseguire il comando Get-TransportAgent | Format-List Name,Priority
e verificare il valore di priorità dell'agente di trasporto.
Disinstallazione di un agente di trasporto tramite Shell
Quando l'agente di trasporto viene disinstallato, Exchange non registra i file DLL utilizzati con l'agente. Non verranno rimossi file, chiavi del Registro di sistema o altri oggetti aggiunti al momento dell'installazione dell'agente di trasporto.
Per disinstallare un agente di trasporto, eseguire il comando riportato di seguito:
Uninstall-TransportAgent <TransportAgentIdentity>
In questo esempio viene disinstallato l'agente di trasporto denominato Fabirkam Transport Agent dal servizio di trasporto su un server Cassette postali.
Uninstall-TransportAgent "Fabrikam Transport Agent"
Come verificare se l'operazione ha avuto esito positivo
Per verificare che l'agente di trasporto sia stato disinstallato correttamente, eseguire il comando Get-TransportAgent
e verificare che l'agente di trasporto non sia elencato.