Install-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 Install-TransportAgent per registrare un agente di trasporto su un computer in cui è installato il ruolo del server Trasporto Edge o Trasporto Hub di un'organizzazione di Microsoft Exchange Server 2007.
Sintassi
Install-TransportAgent -Name <String> -AssemblyPath <String> -TransportAgentFactory <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Il cmdlet Install-TransportAgent viene usato per registrare l'utilizzo di un agente di trasporto in un server Trasporto Edge o Trasporto Hub.
Avviso
Gli agenti di trasporto hanno l'accesso completo a tutti i messaggi di posta elettronica che rilevano. 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 già sperimentati in un ambiente di prova.
Per eseguire il cmdlet Install-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 Install-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 |
|---|---|---|---|
AssemblyPath |
Obbligatorio |
System.String |
Questo parametro consente di specificare il percorso dell'assembly di Microsoft .NET dell'agente di trasporto. Non è possibile utilizzare i percorsi di file UNC (Universal Naming Convention). |
Name |
Obbligatorio |
System.String |
Questo parametro consente di specificare il nome visualizzato dell'agente di trasporto da installare. La lunghezza del nome non può superare i 64 caratteri. |
TransportAgentFactory |
Obbligatorio |
System.String |
Questo parametro consente di specificare il tipo di classe di Microsoft .NET del factory dell'agente di trasporto. Lo sviluppatore dell'agente di trasporto da installare fornisce l'agente di trasporto e le informazioni relative. Per ulteriori informazioni, vedere la documentazione fornita dallo sviluppatore dell'agente di trasporto. |
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. |
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 descritto come un'applicazione antivirus fittizia viene installata in un server Trasporto Edge o Hub Transport.
Install-TransportAgent -Name "Antivirus for Exchange" -TransportAgentFactory "vendor.exchange.avTransportAgentfactory" -AssemblyPath "c:\Program Files\Vendor\TransportAgent\AvTransportAgentFactory.dll"