Share via

Set-ForeignConnector (RTM)

  • Articolo

 

Si applica a: Exchange Server 2007

Ultima modifica dell'argomento: 2007-06-11

Utilizzare il cmdlet Set-ForeignConnector per modificare un connettore esterno esistente su un computer sul cui è in esecuzione Microsoft Exchange Server 2007 e sul quale è installato il ruolo del server Trasporto Hub. Un connettore esterno utilizza una directory di destinazione su un server Trasporto Hub per inviare messaggi a un server di messaggistica locale che non utilizza l'SMTP come meccanismo di trasporto principale. Tali server di messaggistica sono conosciuti come server gateway esterni. Esempi di server gateway esterni sono i server gateway fax di terze parti. Gli spazi indirizzo assegnati a un connettore esterno possono essere SMTP o non SMTP.

Sintassi

Set-ForeignConnector -Identity <ForeignConnectorIdParameter> [-AddressSpaces <MultiValuedProperty>] [-Comment <String>] [-DomainController <Fqdn>] [-DropDirectory <String>] [-DropDirectoryQuota <Unlimited>] [-Enabled <$true | $false>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-RelayDsnRequired <$true | $false>] [-SourceTransportServers <MultiValuedProperty>]

Set-ForeignConnector [-AddressSpaces <MultiValuedProperty>] [-Comment <String>] [-DomainController <Fqdn>] [-DropDirectory <String>] [-DropDirectoryQuota <Unlimited>] [-Enabled <$true | $false>] [-Instance <ForeignConnector>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-RelayDsnRequired <$true | $false>] [-SourceTransportServers <MultiValuedProperty>]

Descrizione dettagliata

Il cmdlet Set-ForeignConnector modifica un connettore esterno esistente. Le modifiche della proprietà specificate quando si utilizza il cmdlet Set-ForeignConnector sovrascrivono i valori esistenti.

Per eseguire il cmdlet Set-ForeignConnector, è necessario utilizzare un account che disponga della delega del ruolo Exchange Server Administrator e del gruppo Administrators locale del server di destinazione.

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

Identity

Obbligatorio

Microsoft.Exchange.Configuration.Tasks.ForeignConnectorIdParameter

Questo parametro specifica il connettore esterno che si desidera modificare. Il parametro Identity può assumere uno dei valori indicati di seguito per l'oggetto connettore esterno:

  • GUID

  • Nome connettore

  • ServerName\ConnectorName

AddressSpaces

Facoltativo

Microsoft.Exchange.Data.MultiValuedProperty

Questo parametro consente di specificare i nomi di dominio a cui il connettore esterno invia i messaggi. È possibile specificare più spazi indirizzo separandoli con una virgola. La sintassi completa per l'inserimento di ciascuno spazio indirizzo è indicata di seguito:

<ConnectorScope>:<AddressSpaceType>:<AddressSpace>;<AddressSpaceCost>

  • ConnectorScope   Se si specifica il valore Local, il connettore può essere utilizzato solo dagli altri server Trasporto Hub che si trovano nello stesso sito di Active Directory del server Trasporto Hub di origine sul quale viene eseguito il cmdlet New-SendConnector. Se si omette il qualificatore ConnectorScope, il connettore può essere utilizzato da tutti i server Trasporto Hub che si trovano nell'intera organizzazione di Exchange 2007.

  • AddressSpaceType   In caso di spazi indirizzo SMTP questo valore deve essere necessariamente SMTP. Mentre in caso di spazi indirizzo non SMTP può essere qualsiasi stringa di testo descrittiva, ad esempio "Lotus Notes".

  • SpazioIndirizzo   Per gli spazi indirizzo SMTP, è possibile utilizzare il carattere jolly (*) del sistema DNS come definito nella RFC 1035, ad esempio utilizzando stringhe quali "*", "*.com" oppure "*.contoso.com". Per gli spazi indirizzo non SMTP, è possibile utilizzare il carattere jolly (*) e altri caratteri come nella stringa "*contoso.com" oppure "@contoso".

  • AddressSpaceCost   L'intervallo di input valido è compreso tra 1 e 100. Un costo inferiore indica una route migliore. Questo parametro è facoltativo. Se si omette il qualificatore AddressSpaceCost quando si inserisce uno spazio indirizzo utilizzando la sintassi completa, viene considerato un costo pari a 1.

È necessario utilizzare la sintassi completa per il parametro AddressSpaces solo nel caso delle condizioni indicate di seguito:

  • Connettori con ambito con qualificatore Local

  • Spazi indirizzo non SMTP

  • Spazi indirizzo SMTP con un costo diverso da 1

Se si inserisce un nome dominio o un elenco di nomi dominio separati da virgole per il valore del parametro AddressSpaces, per ciascun nome dominio si considera che lo spazio indirizzo è di tipo SMTP e che il costo è pari a 1.

Commento

Facoltativo

System.String

Questo parametro specifica un commento facoltativo per il connettore esterno. È necessario racchiudere il parametro Comment tra virgolette doppie, come nell'esempio seguente: "questa è una nota amministrativa".

DomainController

Facoltativo

Microsoft.Exchange.Data.Fqdn

Per specificare il nome di dominio completo (FQDN) del controller di dominio che consente di scrivere e modifiche alla configurazione nel servizio directory di Active Directory, includere il parametro DomainController.

DropDirectory

Facoltativo

System.String

Questo parametro specifica il nome della directory di destinazione che è utilizzata dal connettore esterno corrente. Tutti i messaggi in uscita inviati agli spazi indirizzo definiti da questo connettore esterno sono inseriti nella directory di destinazione specificata. Il percorso della directory di destinazione per ciascun connettore esterno viene controllato dai due elementi seguenti:

  • Parametro RootDropDirectoryPath nel cmdlet Set-TransportServer   Questa opzione viene utilizzata per tutti i connettori esterni esistenti nel server Trasporto Hub. Il valore del parametro RootDropDirectoryPath può essere un percorso locale o un percorso UNC (Universal Naming Convention) a un server remoto.

  • Parametro DropDirectory nel cmdlet Set-ForeignConnector   Questo valore viene impostato per ogni connettore esterno esistente nel server Trasporto Hub.

Per impostazione predefinita, il valore del parametro è vuoto. In questo modo viene indicato che il valore di RootDropDirectoryPath è la cartella di installazione di Exchange 2007. La cartella di installazione predefinita di Exchange 2007 è C:\Programmi\Microsoft\Exchange Server\. Per impostazione predefinita, il valore del parametro DropDirectory è il nome del connettore esterno.

Se il valore del parametro DropDirectory non contiene un percorso assoluto, il percorso della directory di destinazione viene definito dalla combinazione del parametro DropDirectory e del parametro RootDropDirectoryPath. Se il valore del parametro DropDirectory include informazioni di percorso assolute, il valore di RootDropDirectoryPath non deve essere specificato. Il percorso della directory di destinazione è definito solo dal valore del parametro DropDirectory.

La directory di destinazione non viene creata automaticamente. Pertanto, sarà necessario creare manualmente ogni cartella di questa directory.

È necessario che alla directory di destinazione siano assegnate le autorizzazioni seguenti:

  • Servizio di rete: controllo completo

  • Sistema: controllo completo

  • Amministratori: controllo completo

DropDirectoryQuota

Facoltativo

Microsoft.Exchange.Data.Unlimited

Questo parametro specifica la dimensione massima di tutti i file messaggio della directory di destinazione. Quando il valore specificato viene raggiunto, non è possibile copiare alcun nuovo file messaggio nella directory di destinazione finché i messaggi esistenti non vengono recapitati ed eliminati. Quando viene immesso un valore per il parametro DropDirectoryQuota, qualificarlo con una delle unità seguenti:

  • B (byte)

  • KB (kilobyte)

  • MB (megabyte)

  • GB (gigabyte)

  • TB (terabyte)

I valori non qualificati vengono considerati byte. La gamma di immissione valida per questo parametro è compresa tra 1 e 2147483647 byte. Se si immette un valore di unlimited, alla directory di destinazione non viene applicato alcun limite per la dimensione dei messaggi. Il valore predefinito è unlimited.

Enabled

Facoltativo

System.Boolean

Questo parametro abilita o disabilita il connettore esterno. I valori di input validi sono $True o $False. Il valore predefinito è $True.

Instance

Facoltativo

Microsoft.Exchange.Data.Directory.SystemConfiguration.ForeignConnector

Il parametro Instance consente di trasmettere l'intero oggetto al comando da elaborare. Viene utilizzato principalmente negli script in cui è necessario trasmettere l'intero oggetto al comando.

MaxMessageSize

Facoltativo

Microsoft.Exchange.Data.Unlimited

Questo parametro specifica le dimensioni massime di un messaggio che può essere passato tramite il connettore esterno corrente. Quando viene immesso un valore per il parametro MaxMessageSize, qualificarlo con una delle unità seguenti:

  • B (byte)

  • KB (kilobyte)

  • MB (megabyte)

  • GB (gigabyte)

  • TB (terabyte)

I valori non qualificati vengono considerati kilobyte. Se si immette un valore di unlimited, al connettore esterno non viene applicato alcun limite per la dimensione dei messaggi. Il valore predefinito è unlimited. L'intervallo di input valido per questo parametro è compreso tra 0 e 2147483647 kilobyte. Se si imposta il valore del parametro MaxMessageSize su 0, si disabilita il connettore esterno. Tuttavia, se si imposta il valore del parametro MaxMessageSize su 0 quando il valore dell'attributo Enabled è $True, verranno generati errori nel registro eventi. Il metodo preferenziale per disattivare il connettore esterno è utilizzando il parametro Enabled.

Nome

Facoltativo

System.String

Questo parametro specifica un nome descrittivo per il connettore esterno.

RelayDsnRequired

Facoltativo

System.Boolean

Questo parametro specifica se una notifica sullo stato del recapito (DSN) di inoltro è richiesta dal connettore esterno quando i messaggi vengono scritti nella directory di destinazione. I valori di input validi per questo parametro sono $True o $False. Il valore predefinito è $False.

SourceTransportServers

Facoltativo

Microsoft.Exchange.Data.MultiValuedProperty

Questo parametro consente di specificare i nomi dei server Trasporto Hub che utilizzano questo connettore esterno. È possibile specificare più server Trasporto Hub separando i singoli nomi con una virgola. Se un connettore esterno si trova su più server Trasporto Hub, si dispone della tolleranza agli errori e di elevata disponibilità se si verifica un errore in uno dei server Trasporto Hub. Il valore predefinito di questo parametro è il nome del server Trasporto Hub in cui è stato installato per la prima volta questo connettore esterno.

Esempio

Negli esempi di codice seguenti vengono illustrati due esempi di utilizzo del cmdlet Set-ForeignConnector.

Nel primo esempio viene illustrato un comando Set-ForeignConnector che modifica un connettore esterno esistente denominato "Contoso Foreign Connector". Questo comando imposta il parametro MaxMessageSize su 10 MB.

Nel secondo esempio viene illustrato un comando Set-ForeignConnector che modifica gli spazi indirizzo elaborati da un connettore esterno esistente denominato "Contoso Foreign Connector". I dettagli relativi agli spazi indirizzo sono riportati di seguito:

  • Primo spazio indirizzo:

    • Tipo spazio indirizzo: SMTP

    • Spazio indirizzo: "*.contoso.com"

    • Costo dello spazio indirizzo: 1

  • Secondo spazio indirizzo:

    • Tipo spazio indirizzo: Lotus Notes

    • Spazio indirizzo: "*@domino"

    • Costo dello spazio indirizzo: 55

Set-ForeignConnector "Contoso Foreign Connector" -MaxMessageSize 10MB
Set-ForeignConnector "Contoso Foreign Connector" -AddressSpaces ".contoso.com","Lotus Notes:*@domino;55"