New-OutboundConnector

Modulo:

ExchangePowerShell

Si applica a:

Exchange Online, Exchange Online Protection

Questo cmdlet è disponibile solamente nel servizio basato sul cloud.

Usare il cmdlet New-OutboundConnector per creare un connettore in uscita nell'organizzazione basata su cloud.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

New-OutboundConnector
   [-Name] <String>
   [-AllAcceptedDomains <Boolean>]
   [-CloudServicesMailEnabled <Boolean>]
   [-Comment <String>]
   [-Confirm]
   [-ConnectorSource <TenantConnectorSource>]
   [-ConnectorType <TenantConnectorType>]
   [-Enabled <Boolean>]
   [-IsTransportRuleScoped <Boolean>]
   [-LinkForModifiedConnector <Guid>]
   [-RecipientDomains <MultiValuedProperty>]
   [-RouteAllMessagesViaOnPremises <Boolean>]
   [-SenderRewritingEnabled <Boolean>]
   [-SmartHosts <MultiValuedProperty>]
   [-TestMode <Boolean>]
   [-TlsDomain <SmtpDomainWithSubdomains>]
   [-TlsSettings <TlsAuthLevel>]
   [-UseMXRecord <Boolean>]
   [-WhatIf]
   [<CommonParameters>]

Descrizione

I connettori in uscita inviano messaggi di posta elettronica a domini remoti che richiedono opzioni di configurazione specifiche.

È 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-OutboundConnector -Name "Contoso Outbound Connector" -RecipientDomains *.contoso.com -TlsSettings DomainValidation -TlsDomain *.contoso.com

Questo esempio crea il connettore in uscita denominato Contoso Outbound Connector con le seguenti proprietà:

• Invia messaggi ai destinatari nel dominio contoso.com e tutti i sottodomini.
• Usa la crittografia TLS e verifica dei certificati per la posta instradata al dominio contoso.com e a tutti i sottodomini

Parametri

-AllAcceptedDomains

Il parametro AllAcceptedDomains specifica se il connettore in uscita viene usato nelle organizzazioni ibride in cui i destinatari dei messaggi si trovano nei domini accettati dell'organizzazione basata sul cloud. I valori validi sono:

• $true: il connettore in uscita viene usato nelle organizzazioni ibride quando i destinatari dei messaggi si trovano in un dominio accettato dell'organizzazione basata sul cloud. Questa impostazione richiede OnPremises per il valore ConnectorType.
• $false: il connettore in uscita non viene usato nelle organizzazioni ibride. Questo è il valore predefinito.

Questo parametro è valido solo per i connettori OnPremises.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-CloudServicesMailEnabled

Nota: è consigliabile non usare questo parametro a meno che non si sia invitati a farlo tramite Microsoft servizio clienti e supporto tecnico o dalla documentazione specifica del prodotto. Usare invece la configurazione guidata ibrida per configurare il flusso di posta tra le organizzazioni locali e cloud. Per ulteriori informazioni, vedere Procedura guidata di configurazione ibrida.

Il parametro CloudServicesMailEnabled specifica se il connettore viene usato per il flusso di posta ibrido tra un ambiente Exchange locale e Microsoft 365. In particolare, questo parametro controlla il modo in cui determinate intestazioni di messaggio X-MS-Exchange-Organization-* interne vengono gestite nei messaggi inviati tra domini accettati nelle organizzazioni locali e cloud. Queste intestazioni sono collettivamente note come intestazioni cross-premise.

I valori validi sono:

• $true: il connettore viene usato per il flusso di posta nelle organizzazioni ibride, quindi le intestazioni cross-premise vengono mantenute o alzate di livello nei messaggi che passano attraverso il connettore. Questo è il valore predefinito per i connettori creati dalla configurazione guidata ibrida. Alcune intestazioni X-MS-Exchange-Organization-* nei messaggi in uscita inviati da un lato dell'organizzazione ibrida all'altra vengono convertite in intestazioni X-MS-Exchange-CrossPremises-* e vengono quindi mantenute nei messaggi. Le intestazioni X-MS-Exchange-CrossPremises-* nei messaggi in ingresso ricevuti da un lato dell'organizzazione ibrida dall'altro vengono alzate di livello a intestazioni X-MS-Exchange-Organization-*. Queste intestazioni alzate di livello sostituiscono tutte le istanze delle stesse intestazioni X-MS-Exchange-Organization-* già presenti nei messaggi.
• $false: il connettore non viene usato per il flusso di posta nelle organizzazioni ibride, quindi le intestazioni cross-premise vengono rimosse dai messaggi che passano attraverso il connettore.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-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 Online, Exchange Online Protection

-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 Online, Exchange Online Protection

-ConnectorSource

Il parametro ConnectorSource consente di specificare come viene creato il connettore. I valori validi sono:

• Default: il connettore viene creato manualmente. Questo è il valore predefinito quando si usa questo cmdlet e si consiglia di non modificare questo valore.
• HybridWizard: Il connettore viene creato automaticamente dalla procedura guidata di configurazione ibrida.
• Migrated: il connettore è stato originariamente creato in Microsoft Forefront Online Protection per Exchange.

Type:	TenantConnectorSource
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-ConnectorType

Il parametro ConnectorType consente di specificare una categoria per i domini che vengono gestiti dal connettore. I valori validi sono:

• Partner: il connettore gestisce i domini esterni all'organizzazione.
• OnPremises: il connettore gestisce i domini utilizzati dall'organizzazione locale.

Type:	TenantConnectorType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Enabled

Il parametro Enabled consente di specificare se abilitare o disabilitare il connettore in uscita. I valori validi sono:

• $true: il connettore è abilitato. Questo è il valore predefinito.
• $false: il connettore è disabilitato.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-IsTransportRuleScoped

Il parametro IsTransportRuleScoped specifica se il connettore in uscita è associato a una regola di trasporto (nota anche come regola del flusso di posta). I valori validi sono:

• $true: il connettore è associato a una regola di trasporto.
• $false: il connettore non è associato a una regola di trasporto. Questo è il valore predefinito.

È possibile definire l'ambito di una regola di trasporto a un connettore in uscita usando il parametro RouteMessageOutboundConnector nei cmdlet New-TransportRule o Set-TransportRule. I messaggi che corrispondono alle condizioni della regola di trasporto vengono indirizzati alle rispettive destinazioni usando il connettore in uscita specificato.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-LinkForModifiedConnector

Questo parametro è riservato all'uso interno da parte di Microsoft.

Type:	Guid
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Name

Il parametro Name consente di specificare il nome univoco per il connettore. La lunghezza massima è 64 caratteri. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-RecipientDomains

Il parametro RecipientDomains consente di specificare i domini a cui il connettore in uscita indirizza la posta. È possibile specificare più domini separati da virgole.

È possibile utilizzare un carattere jolly per specificare tutti i sottodomini di un determinato dominio, come illustrato nell'esempio seguente: *.contoso.com. Tuttavia, non è possibile incorporare un carattere jolly, come illustrato nell'esempio seguente: domain.*.contoso.com.

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-RouteAllMessagesViaOnPremises

Il parametro RouteAllMessagesViaOnPremises specifica che tutti i messaggi forniti da questo connettore vengono prima indirizzati attraverso il sistema di posta elettronica locale nelle organizzazioni ibride. I valori validi sono:

• $true: i messaggi vengono indirizzati attraverso il sistema di posta elettronica locale. Questa impostazione richiede OnPremises per il valore ConnectorType.
• $false: i messaggi non vengono indirizzati attraverso il sistema di posta elettronica locale. Questo è il valore predefinito.

Questo parametro è valido solo per i connettori OnPremises.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-SenderRewritingEnabled

Il parametro SenderRewritingEnabled specifica che tutti i messaggi normalmente idonei per la riscrittura SRS vengono riscritti per il routing tramite il sistema di posta elettronica locale. I valori validi sono:

• $true: i messaggi vengono riscritti da SRS in base alle esigenze prima di essere indirizzati attraverso il sistema di posta elettronica locale. Questa impostazione richiede OnPremises per il valore ConnectorType.
• $false: i messaggi non vengono riscritti da SRS prima di essere indirizzati attraverso il sistema di posta elettronica locale. Questo è il valore predefinito.

Questo parametro è valido solo per i connettori OnPremises.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-SmartHosts

Il parametro SmartHosts specifica lo smart host usato dal connettore in uscita per instradare la posta. I valori validi sono:

• FQDN di un server smart host, un record di scambio di posta (MX) o un record di indirizzo (A): ad esempio, mail.contoso.com.
• Indirizzo IP singolo: ad esempio, 10.10.1.1.
• Intervallo di indirizzi IP CIDR (Classless InterDomain Routing): ad esempio, 192.168.0.1/25.

È possibile specificare più valori separati da virgole: "Value1","Value2",..."ValueN".

Questo parametro è obbligatorio se si usa il valore $false per il parametro UseMxRecord.

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-TestMode

Il parametro TestMode consente di specificare se si vuole abilitare o disabilitare la modalità di test per il connettore in uscita. I valori validi sono:

• $true: la modalità di test è abilitata.
• $false: la modalità di test è disabilitata. Questo è il valore predefinito.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-TlsDomain

Il parametro TlsDomain consente di specificare il nome di dominio utilizzato dal connettore in uscita per verificare il nome di dominio completo del certificato di destinazione quando viene stabilita una connessione TLS protetta. Un valore valido per questo parametro è un dominio SMTP.

I caratteri jolly sono supportati per specificare tutti i sottodomini di un dominio ,ad esempio *.contoso.com, ma non è possibile incorporare il carattere jolly all'interno del dominio, ad esempio dominio.*.contoso.com.

Questo parametro è significativo solo quando il valore di TlsSettings è DomainValidation.

Type:	SmtpDomainWithSubdomains
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-TlsSettings

Il parametro TlsSettings consente di specificare il livello di autenticazione TLS utilizzato per le connessioni TLS in uscita stabilite da questo connettore in uscita. I valori validi sono:

• EncryptionOnly: TLS è utilizzato solo per crittografare il canale di comunicazione. Non viene eseguita alcuna autenticazione del certificato.
• CertificateValidation: TLS viene usato per crittografare i controlli di convalida della catena di certificati e del canale e degli elenchi di revoche.
• DomainValidation: oltre alla crittografia del canale e alla convalida del certificato, il connettore in uscita verifica anche che il nome di dominio completo del certificato di destinazione corrisponda al dominio specificato nel parametro TlsDomain.
• $null (vuoto): valore predefinito.

Type:	TlsAuthLevel
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-UseMXRecord

Il parametro UseMXRecord abilita o disabilita il routing DNS per il connettore. I valori validi sono:

• $true: il connettore usa il routing DNS (record MX in DNS) per recapitare la posta elettronica. Questo è il valore predefinito.
• $false: il connettore recapita la posta elettronica a uno o più host intelligenti. Questa impostazione richiede uno o più host intelligenti per il valore SmartHosts.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-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 Online, Exchange Online Protection

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.