Set-ForeignConnector
Questo cmdlet è disponibile solo in Exchange locale.
Utilizzare il cmdlet Set-ForeignConnector per modificare un connettore esterno esistente nel servizio di trasporto di un server Cassette postali.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Set-ForeignConnector
[-Identity] <ForeignConnectorIdParameter>
[-AddressSpaces <MultiValuedProperty>]
[-Comment <String>]
[-Confirm]
[-DomainController <Fqdn>]
[-DropDirectory <String>]
[-DropDirectoryQuota <Unlimited>]
[-Enabled <Boolean>]
[-Force]
[-IsScopedConnector <Boolean>]
[-MaxMessageSize <Unlimited>]
[-Name <String>]
[-RelayDsnRequired <Boolean>]
[-SourceTransportServers <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>] Descrizione
Un connettore esterno utilizza una directory di destinazione nel servizio di trasporto di un server Cassette postali per inviare messaggi a un server di messaggistica locale che non utilizza SMTP come meccanismo di trasporto primario. Tali server di messaggistica sono conosciuti come server gateway esterni. I server gateway fax di terze parti sono esempi di server gateway esterni. Gli spazi indirizzo che è possibile assegnare a un connettore esterno possono essere SMTP o non SMTP.
È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.
Esempio
Esempio 1
Set-ForeignConnector "Fax Connector" -MaxMessageSize 10MBIn questo esempio vengono configurati 10 MB come dimensione massima dei messaggi sul connettore esterno esistente denominato Fax Connector.
Parametri
-AddressSpaces
Il parametro AddressSpaces consente di specificare i nomi di dominio a cui il connettore esterno invia i messaggi. La sintassi completa per l'immissione di ogni spazio indirizzi è: 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 : i valori validi per il costo sono compresi 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 racchiudere lo spazio indirizzo tra virgolette ("). 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 di indirizzi separando gli spazi degli indirizzi con virgole, ad esempio: contoso.com,fabrikam.com. Se si specifica il tipo di spazio indirizzi o il costo dello spazio indirizzi, è necessario racchiudere lo spazio indirizzi tra virgolette ("), ad esempio: "contoso.com;2","fabrikam.com;3".
Per aggiungere o rimuovere uno o più valori di spazio indirizzi senza influire sulle voci esistenti, usare la sintassi seguente: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Comment
Il parametro Comment consente di specificare un commento facoltativo. Se si specifica un valore che contiene degli spazi, è necessario racchiuderlo tra virgolette ("); ad esempio: "Questa è una nota per amministratori".
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Confirm
L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.
- I cmdlet distruttivi , ad esempio i cmdlet Remove-*, hanno una pausa predefinita che impone di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi:
-Confirm:$false. - La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non hanno una pausa predefinita. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DomainController
Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, dc01.contoso.com.
Il parametro DomainController non è supportato sui server Trasporto Edge. Un server Trasporto Edge usa l'istanza locale di Active Directory Lightweight Directory Services (AD LDS) per leggere e scrivere i dati.
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DropDirectory
Il parametro DropDirectory consente di specificare il nome della directory di destinazione utilizzata da questo connettore esterno. 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:
- Il parametro RootDropDirectoryPath nel cmdlet Set-TransportService: Questa opzione viene utilizzata per tutti i connettori esterni esistenti sul server Cassette postali. Il valore del parametro RootDropDirectoryPath può essere un percorso locale o un percorso UNC (Universal Naming Convention) di un server remoto.
- Il parametro DropDirectory nel cmdlet Set-ForeignConnector: Questo valore viene impostato per ogni connettore esterno esistente sul server.
Per impostazione predefinita, il parametro RootDropDirectoryPath è vuoto. Indica che il valore di RootDropDirectoryPath è la cartella di installazione di Exchange 2010. La cartella di installazione predefinita di Exchange 2010 è 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 è stata creata. È pertanto necessario creare manualmente ciascuna cartella della directory di destinazione.
È necessario che alla directory di destinazione siano assegnate le autorizzazioni seguenti:
- Servizio di rete: controllo completo
- Sistema: controllo completo
- Amministratori: controllo completo
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DropDirectoryQuota
Il parametro DropDirectoryQuota consente di specificare la dimensione massima di tutti i file di messaggio nella 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.
Nel caso venga immesso un valore, qualificarlo con una delle seguenti unità:
- B (byte)
- KB (kilobyte)
- MB (megabyte)
- GB (gigabyte)
- TB (terabyte)
TB (terabyte)
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 è illimitato.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Enabled
Il parametro Enabled consente di specificare se attivare il connettore esterno. I valori validi sono $true e $false. Il valore predefinito è $true.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Force
L'opzione Forza nasconde i messaggi di avviso o di conferma. Con questa opzione non è necessario specificare alcun valore.
È possibile utilizzare questa opzione per eseguire attività a livello di programmazione, se la richiesta di un input amministrativo è inappropriata.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Identity
Il parametro Identity consente di specificare 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
| Type: | ForeignConnectorIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-IsScopedConnector
Il parametro IsScopedConnector consente di specificare la disponibilità del connettore per altri server Cassette postali. Quando il valore di questo parametro è $false, il connettore può essere usato da tutti i server Cassette postali nell'organizzazione di Exchange. Quando il valore di questo parametro è $true, il connettore può essere usato solo dai server Cassette postali nello stesso sito di Active Directory. Il valore predefinito è $false.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-MaxMessageSize
Il parametro MaxMessageSize consente di specificare le dimensioni massime di un messaggio che può essere passato tramite il connettore esterno.
Nel caso venga immesso un valore, qualificarlo con una delle seguenti unità:
- B (byte)
- KB (kilobyte)
- MB (megabyte)
- GB (gigabyte)
- TB (terabyte)
TB (terabyte)
Se si immette un valore di unlimited, al connettore esterno non viene applicato alcun limite per la dimensione dei messaggi. Il valore predefinito è illimitato. L'intervallo di input valido per questo parametro è compreso tra 0 e 2147483647 byte. Se si imposta il valore del parametro MaxMessageSize su 0, si disattiva il connettore esterno. Tuttavia, se si imposta il valore del parametro MaxMessageSize su 0 quando il valore dell'attributo Enabled è $true, si genereranno errori nel registro eventi. Il metodo preferenziale per disattivare il connettore esterno è utilizzare il parametro Enabled.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Name
Il parametro Name consente di specificare un nome descrittivo per il connettore esterno.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-RelayDsnRequired
Il parametro RelayDsnRequired consente di specificare 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-SourceTransportServers
Il parametro SourceTransportServers consente di specificare i nomi dei server Cassette postali che utilizzano questo connettore esterno. Avere un singolo connettore esterno su più server Cassette postali sui quali è in esecuzione il servizio di trasporto garantisce la tolleranza ai guasti e un'elevata disponibilità in caso di guasto di uno dei server. Il valore predefinito di questo parametro è il nome del server Cassette postali su cui è stato installato per la prima volta questo connettore esterno.
Per immettere più valori e sovrascrivere le voci esistenti, usare la sintassi seguente: Value1,Value2,...ValueN. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN".
Per aggiungere o rimuovere uno o più valori senza influire sulle voci esistenti, usare la sintassi seguente: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-WhatIf
L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
Input
Input types
Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.
Output
Output types
Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.