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 10

In 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.SourceTransportServers

In 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.