New-DeliveryAgentConnector
Questo cmdlet è disponibile solo in Exchange locale.
Il cmdlet New-DeliveryAgentConnector consente di creare un nuovo connettore dell'agente di recapito all'interno dell'organizzazione.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
New-DeliveryAgentConnector
[-Name] <String>
-AddressSpaces <MultiValuedProperty>
-DeliveryProtocol <String>
[-Comment <String>]
[-Confirm]
[-DomainController <Fqdn>]
[-Enabled <Boolean>]
[-IsScopedConnector <Boolean>]
[-MaxConcurrentConnections <Int32>]
[-MaxMessageSize <Unlimited>]
[-MaxMessagesPerConnection <Int32>]
[-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 di gestire le code di connettori esterni, eliminando, così, la necessità di archiviare i messaggi nel 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
New-DeliveryAgentConnector -Name "Contoso X.400 Connector" -AddressSpaces "X400:c=US;a=Fabrikam;p=Contoso;1" -DeliveryProtocol "X.400" -SourceTransportServers Hub01,Hub02,Hub05
In questo esempio, viene creato un connettore dell'agente di recapito denominato Contoso X.400 Connector con la seguente configurazione:
Il connettore dell'agente di recapito è ospitato nei seguenti server:
- Hub01
- Hub02
- Hub05
Il connettore dell'agente di recapito è progettato per gestire le connessioni X.400 per una società denominata Contoso che utilizza l'operatore Fabrikam.
Lo spazio indirizzo per il connettore è c=US;a=Fabrikam;p=Contoso.
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: | True |
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: | True |
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 |
-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 interrompe la connessione una volta raggiunto il limite e il server di invio deve avviare una nuova connessione per inviare ulteriori 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: | 1 |
Default value: | None |
Required: | True |
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.