Condividi tramite


New-InboundConnector

Questo cmdlet è disponibile solamente nel servizio basato sul cloud.

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

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

Sintassi

New-InboundConnector
   [-Name] <String>
   -SenderDomains <MultiValuedProperty>
   [-AssociatedAcceptedDomains <MultiValuedProperty>]
   [-CloudServicesMailEnabled <Boolean>]
   [-Comment <String>]
   [-Confirm]
   [-ConnectorSource <TenantConnectorSource>]
   [-ConnectorType <TenantConnectorType>]
   [-EFSkipIPs <MultiValuedProperty>]
   [-EFSkipLastIP <Boolean>]
   [-EFSkipMailGateway <MultiValuedProperty>]
   [-EFTestMode <Boolean>]
   [-EFUsers <MultiValuedProperty>]
   [-Enabled <Boolean>]
   [-RequireTls <Boolean>]
   [-RestrictDomainsToCertificate <Boolean>]
   [-RestrictDomainsToIPAddresses <Boolean>]
   [-ScanAndDropRecipients <MultiValuedProperty>]
   [-SenderIPAddresses <MultiValuedProperty>]
   [-TlsSenderCertificateName <TlsCertificate>]
   [-TreatMessagesAsInternal <Boolean>]
   [-TrustedOrganizations <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]

Descrizione

I connettori in entrata accettano i messaggi di posta elettronica proveniente dai 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-InboundConnector -Name "Contoso Inbound Connector" -SenderDomains *.contoso.com -SenderIPAddresses 192.168.0.1/25 -RestrictDomainsToIPAddresses $true

Questo esempio crea il connettore in ingresso denominato Contoso Inbound Connector con le seguenti proprietà:

  • Ascolta le connessioni in ingresso dal dominio contoso.com e tutti i sottodomini.
  • Accetta solo la posta proveniente da contoso.com, e dall'intervallo di indirizzi IP 192.168.0.1/25. Rifiuta la posta proveniente da contoso.com se originata da qualsiasi altro indirizzo IP.

Esempio 2

New-InboundConnector -Name "Contoso Inbound Secure Connector" -SenderDomains *.contoso.com -SenderIPAddresses 192.168.0.1/25 -RestrictDomainsToIPAddresses $true -RequireTLS $true -TlsSenderCertificateName *.contoso.com

Questo esempio crea il connettore in ingresso denominato Contoso Inbound Secure Connector e richiede la trasmissione TLS per tutti i messaggi.

Parametri

-AssociatedAcceptedDomains

Il parametro AssociatedAcceptedDomains limita i domini di origine che usano il connettore ai domini accettati specificati. Un valore valido è un dominio SMTP configurato come dominio accettato nell'organizzazione di Microsoft 365.

È possibile specificare più valori separati da virgole.

Type:MultiValuedProperty
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 venga richiesto dal servizio clienti e dal supporto tecnico Microsoft 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 tutte 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. Di seguito sono riportati alcuni dei valori validi per questo parametro.

  • Default: il connettore viene creato manualmente. Questo è il valore predefinito.
  • 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.

È consigliabile non modificare questo valore.

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 la categoria per i domini di origine per cui il connettore accetta i messaggi. I valori validi sono:

  • Partner: partner o servizi esterni.
  • OnPremises: organizzazione di posta elettronica locale. Utilizzare questo valore per i domini accettati nell'organizzazione basata su cloud che sono anche specificati dal parametro SenderDomains.
Type:TenantConnectorType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-EFSkipIPs

il parametro EFSkipIPs specifica gli indirizzi IP di origine da ignorare nel filtro avanzato per i connettori quando viene $false il valore del parametro EFSkipLastIP. I valori validi sono:

  • Indirizzo IP singolo: ad esempio, 192.168.1.1.
  • Intervallo di indirizzi IP: ad esempio, 192.168.0.1-192.168.0.254.
  • Intervallo di indirizzi IP CIDR (Classless InterDomain Routing): ad esempio, 192.168.3.1/24.

È possibile specificare più valori separati da virgole.

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

-EFSkipLastIP

Il parametro EFSkipIPs specifica il comportamento del filtro avanzato per i connettori. I valori validi sono:

  • $true: viene ignorata solo l'ultima origine del messaggio.
  • $false: ignorare gli indirizzi IP di origine specificati dal parametro EFSkipIPs. Se non viene specificato alcun indirizzo IP, il filtro avanzato per i connettori viene disabilitato nel connettore. 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

-EFSkipMailGateway

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

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

-EFTestMode

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

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

-EFUsers

Il parametro EFUsers consente di specificare i destinatari a cui si applica il filtro avanzato per i connettori. Il valore predefinito è vuoto ($null), il che significa che il filtro avanzato per i connettori viene applicato a tutti i destinatari.

È possibile indicare più indirizzi di posta elettronica dei destinatari separati da virgole.

Type:MultiValuedProperty
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 abilitare o disabilitare il connettore. 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

-Name

Il parametro Name consente di specificare un nome descrittivo per il connettore.

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

-RequireTls

Il parametro RequireTLS consente di specificare se richiedere la trasmissione TLS per tutti i messaggi ricevuti dal connettore. I valori validi sono:

  • $true: rifiutare i messaggi se non vengono inviati tramite TLS. Questo è il valore predefinito
  • $false: consente i messaggi se non vengono inviati tramite TLS.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-RestrictDomainsToCertificate

Il parametro RestrictDomainsToCertificate specifica se il valore Subject del certificato TLS viene controllato prima che i messaggi possano usare il connettore. I valori validi sono:

  • $true: La posta elettronica può usare il connettore solo se il valore Subject del certificato TLS usato dal server di posta elettronica di origine per l'autenticazione corrisponde al valore del parametro TlsSenderCertificateName.
  • $false: il valore Subject del certificato TLS usato dal server di posta elettronica di origine per l'autenticazione non controlla se la posta da tale origine usa il connettore. 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

-RestrictDomainsToIPAddresses

Il parametro RestrictDomainsToIPAddresses specifica se rifiutare la posta proveniente da indirizzi IP di origine sconosciuti. I valori validi sono:

  • $true: rifiuta automaticamente la posta dai domini specificati dal parametro SenderDomains se l'indirizzo IP di origine non è specificato anche dal parametro SenderIPAddress.
  • $false: non rifiutare automaticamente la posta da domini specificati dal parametro SenderDomains in base all'indirizzo IP di origine. 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

-ScanAndDropRecipients

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

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

-SenderDomains

Il parametro SenderDomains consente di specificare i domini di origine per i quali il connettore accetta i messaggi. Un valore valido è un dominio SMTP. I caratteri jolly sono supportati per indicare un dominio e tutti i sottodomini ,ad esempio *.contoso.com, ma non è possibile incorporare il carattere jolly( ad esempio, dominio.*.contoso.com non è valido).

È possibile specificare più domini separati da virgole.

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

-SenderIPAddresses

Il parametro SenderIPAddresses consente di specificare gli indirizzi IP IPV4 di origine da cui il connettore accetta i messaggi. I valori validi sono:

  • Indirizzo IP singolo: ad esempio, 192.168.1.1.
  • Intervallo di indirizzi IP CIDR (Classless InterDomain Routing): ad esempio, 192.168.0.1/25. I valori validi della subnet mask sono compresi tra /24 e /32.

È possibile indicare più indirizzi IP separati da virgole.

Gli indirizzi IPv6 non sono supportati.

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

-TlsSenderCertificateName

Il parametro TlsSenderCertificateName specifica il certificato TLS usato quando viene $true il valore del parametro RequireTls. Un valore valido è un dominio SMTP. I caratteri jolly sono supportati per indicare un dominio e tutti i sottodomini ,ad esempio *.contoso.com, ma non è possibile incorporare il carattere jolly( ad esempio, dominio.*.contoso.com non è valido).

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

-TreatMessagesAsInternal

Il parametro TreatMessagesAsInternal specifica un metodo alternativo per identificare i messaggi inviati da un'organizzazione locale come messaggi interni. È consigliabile usare questo parametro solo quando l'organizzazione locale non usa Exchange. I valori validi sono:

  • $true: i messaggi vengono considerati interni se il dominio del mittente corrisponde a un dominio configurato in Microsoft 365. Questa impostazione consente il flusso di posta interno tra Microsoft 365 e le organizzazioni locali che non hanno installato Exchange Server 2010 o versioni successive. Tuttavia, questa impostazione presenta potenziali rischi per la sicurezza(ad esempio, i messaggi interni ignorano il filtro antispam), quindi prestare attenzione durante la configurazione di questa impostazione.
  • $false: i messaggi non vengono considerati interni. Questo è il valore predefinito.

Negli ambienti ibridi non è necessario usare questo parametro, perché la configurazione guidata ibrida configura automaticamente le impostazioni necessarie nel connettore in ingresso in Microsoft 365 e nel connettore di invio nell'organizzazione exchange locale (il parametro CloudServicesMailEnabled).

Nota: non è possibile impostare questo parametro sul valore $true se una delle condizioni seguenti è vera:

  • Il parametro CloudServicesMailEnabled è impostato sul valore $true.
  • Il valore del parametro ConnectorType non è 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

-TrustedOrganizations

Il parametro TrustedOrganizations consente di specificare altre organizzazioni di Microsoft 365 che sono origini di posta attendibili, ad esempio dopo acquisizioni e fusioni. È possibile specificare più organizzazioni di Microsoft 365 separate da virgole.

Questo parametro funziona solo per il flusso di posta tra due organizzazioni di Microsoft 365, quindi non vengono usati altri parametri.

Type:MultiValuedProperty
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.