Condividi tramite

Set-ForeignConnector

  • Articolo

 

Si applica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Ultima modifica dell'argomento: 2007-06-28

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. Questi server di messaggistica sono noti 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>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-DropDirectory <String>] [-DropDirectoryQuota <Unlimited>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-IsScopedConnector <$true | $false>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-RelayDsnRequired <$true | $false>] [-SourceTransportServers <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]]

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

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 seguenti per l'oggetto Connettore esterno:

  • GUID

  • Nome connettore

  • ServerName\ConnectorName

AddressSpaces

Facoltativo

Microsoft.Exchange.Data.MultiValuedProperty

Questo parametro specifica i nomi di dominio cui il connettore esterno invia messaggi. La sintassi completa per l'inserimento di ciascuno spazio indirizzo è indicata di seguito: <AddressSpaceType>:<AddressSpace>;<AddressSpaceCost>

  • AddressSpaceType   Il tipo di spazio indirizzo può essere SMTP, X400 o qualsiasi altra stringa di testo. Se si omette il tipo di spazio indirizzo, viene considerato implicitamente un tipo di spazio indirizzo SMTP.

  • AddressSpace   Per i tipi di spazio indirizzo SMTP, lo spazio indirizzo immesso deve essere conforme a RFC 1035. Ad esempio, *, *.com e *.contoso.com sono consentiti, ma *contoso.com non è consentito. Per i tipi di spazio indirizzo X.400, lo spazio indirizzo immesso deve essere conforme a RFC 1685, ad esempio o=MySite;p=MyOrg;a=adatum;c=us. Per tutti gli altri valori del tipo di indirizzo, è possibile immettere qualsiasi testo per lo spazio indirizzo.

  • AddressSpaceCost   L'intervallo di input valido è compreso tra 1 e 100. Un costo inferiore indica una route migliore. Se si omette il costo di uno spazio indirizzo, viene considerato implicitamente un costo di 1. Se si immette uno spazio indirizzo non SMTP contenente un punto e virgola ( ; ), è necessario specificare il costo dello spazio indirizzo.

Se si specifica il tipo di spazio indirizzo o il costo dello spazio indirizzo, è necessario includere lo spazio indirizzo tra virgolette doppie ( " ). Ad esempio, le seguenti voci di spazio indirizzo sono equivalenti:

  • "SMTP:contoso.com;1"

  • "contoso.com;1"

  • "SMTP:contoso.com"

  • contoso.com

È possibile specificare più spazi indirizzo separandoli con una virgola nel modo indicato di seguito: contoso.com,fabrikam.com. Se si specifica il tipo di spazio indirizzo o il costo dello spazio indirizzo, è necessario includere lo spazio indirizzo tra virgolette doppie ( " ), ad esempio: "contoso.com;2","fabrikam.com;3".

Comment

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 è un nota dell'amministratore".

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 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. Questo indica che il valore di RootDropDirectoryPath è la cartella di installazione di Exchange 2007. La cartella di installazione di Exchange 2007 predefinita è 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. L'intervallo di input valido per questo parametro è compreso 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.

Force

Facoltativo

System.Management.Automation.SwitchParameter

Questo parametro consente di eliminare i messaggi di avviso o di conferma che vengono visualizzati durante modifiche specifiche alla configurazione.

Instance

Facoltativo

Microsoft.Exchange.Data.Directory.SystemConfiguration.ForeignConnector

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

IsScopedConnector

Facoltativo

System.Boolean

Questo parametro consente di controllare la disponibilità del connettore per altri server Trasporto Hub. Quando il valore del parametro è $False, tutti i server Trasporto Hub nell'organizzazione di Exchange possono utilizzare il connettore. Quando il valore del parametro è $True, solo i server Trasporto Hub nello stesso sito di Active Directory possono utilizzare il connettore. Il valore predefinito è $False.

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.

Name

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 specifica il nome dei server Trasporto Hub che utilizzano il connettore esterno corrente. È possibile specificare più server Trasporto Hub separati da virgole. Un singolo connettore esterno situato su più server Trasporto Hub offre tolleranza d'errore ed elevata disponibilità se su uno dei server Trasporto Hub si verifica un errore. Il valore predefinito di questo parametro è il nome del server Trasporto Hub sul quale il connettore esterno corrente è stato installato per primo.

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.

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"