Set-DeliveryAgentConnector
Questo cmdlet è disponibile solo in Exchange locale.
Usare il cmdlet Set-DeliveryAgentConnector per configurare un connettore dell'agente di recapito specifico nell'organizzazione.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Set-DeliveryAgentConnector
[-Identity] <DeliveryAgentConnectorIdParameter>
[-AddressSpaces <MultiValuedProperty>]
[-Comment <String>]
[-Confirm]
[-DeliveryProtocol <String>]
[-DomainController <Fqdn>]
[-Enabled <Boolean>]
[-Force]
[-IsScopedConnector <Boolean>]
[-MaxConcurrentConnections <Int32>]
[-MaxMessageSize <Unlimited>]
[-MaxMessagesPerConnection <Int32>]
[-Name <String>]
[-SourceTransportServers <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>] Descrizione
I connettori dell'agente di recapito vengono utilizzati per instradare i messaggi indirizzati a sistemi esterni che non utilizzano il protocollo SMTP. Quando un messaggio viene instradato a un connettore dell'agente di recapito, l'agente di recapito associato esegue la conversione del contenuto e il recapito del messaggio. I connettori dell'agente di recapito consentono la gestione delle code dei connettori esterni, eliminando, di conseguenza, la necessità di memorizzare i messaggi sul file system nelle directory di destinazione e prelievo. Per ulteriori informazioni, vedere Agenti di recapito e connettori agente di recapito.
È 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-DeliveryAgentConnector "Contoso X.400 Connector" -MaxMessageSize 10MB -MaxMessagesPerConnection 100 -MaxConcurrentConnections 10In questo esempio vengono configurate le restrizioni per il connettore dell'agente di recapito Contoso X.400 Connector. Apporta le modifiche di configurazione seguenti:
Imposta le dimensioni massime dei messaggi consentite tramite il connettore su 10 MB.
Imposta il numero massimo di messaggi consentiti per ogni connessione su 100.
Imposta le connessioni simultanee massime su 10.
Esempio 2
$ConnectorConfig = Get-DeliveryAgentConnector "Contoso X.400 Connector"
$ConnectorConfig.AddressSpaces += "X400:c=US;p=Fabrikam;a=Contoso;o=Sales;1"
$ConnectorConfig.SourceTransportServers += Hub04; Set-DeliveryAgentConnector "Contoso X.400 Connector" -AddressSpaces $ConnectorConfig.AddressSpaces -SourceTransportServers $ConnectorConfig.SourceTransportServersIn questo esempio viene utilizzata la variabile temporanea $ConnectorConfig per aggiungere lo spazio degli indirizzi c=US;p=Fabrikam;a=Contoso;o=Sales al connettore dell'agente di recapito Contoso X.400 e aggiunge anche il server Hub04 all'elenco dei server che ospitano il connettore.
Parametri
-AddressSpaces
Il parametro AddressSpaces consente di specificare i nomi di dominio di cui è responsabile il connettore dell'agente di recapito. La sintassi completa per l'immissione di uno spazio indirizzi è: AddressSpaceType:AddressSpace;AddressSpaceCost. Racchiudere ogni spazio di indirizzi tra virgolette (").
| 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 |
-DeliveryProtocol
Il parametro DeliveryProtocol consente di specificare il protocollo di comunicazione che determina gli agenti di recapito responsabili del servizio del connettore.
| 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 |
-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 |
-Enabled
Il parametro Enabled consente di specificare se il connettore dell'agente di recapito è abilitato.
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 GUID o il nome del connettore dell'agente di recapito.
| Type: | DeliveryAgentConnectorIdParameter |
| 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. Se il valore di questo parametro è $false, tutti i server Cassette postali nell'organizzazione possono utilizzare il connettore. Se 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 |
-MaxConcurrentConnections
Il parametro MaxConcurrentConnections consente di specificare il numero massimo di connessioni contemporanee provenienti da uno specifico indirizzo IP accettate dal connettore.
Il valore predefinito è 5.
| Type: | Int32 |
| 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 specifica la dimensione massima di un messaggio che può essere passato tramite il connettore. Nel caso venga immesso un valore, qualificarlo con una delle seguenti unità:
- B (byte)
- KB (kilobyte)
- MB (megabyte)
- GB (gigabyte)
I valori non qualificati vengono considerati byte. L'intervallo di input valido per questo parametro è compreso tra 65536 e 2147483647 byte.
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 |
-MaxMessagesPerConnection
Il parametro MaxMessagesPerConnection consente di specificare il numero massimo di messaggi accettati dal connettore per ogni connessione. Il connettore termina la connessione dopo il raggiungimento di questo limite e il server di invio deve avviare una nuova connessione per inviare altri messaggi.
Il valore predefinito è 20.
| Type: | Int32 |
| 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 il nome di questo connettore dell'agente di recapito. Il valore del parametro Name non può superare 64 caratteri.
| 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 |
-SourceTransportServers
Il parametro SourceTransportServers consente di specificare l'elenco dei server Cassette postali che ospitano questo connettore. È possibile specificare più server separando i loro nomi con virgole.
Per impostazione predefinita, al parametro viene aggiunto solo il server locale su cui viene eseguito il parametro.
| 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.