Set-InboundConnector

Questo cmdlet è disponibile solamente nel servizio basato sul cloud.

Il cmdlet Set-InboundConnector consente di modificare un connettore in entrata esistente nell'organizzazione basata su cloud.

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

Sintassi

Set-InboundConnector
   [-Identity] <InboundConnectorIdParameter>
   [-AssociatedAcceptedDomains <MultiValuedProperty>]
   [-CloudServicesMailEnabled <Boolean>]
   [-Comment <String>]
   [-Confirm]
   [-ConnectorSource <TenantConnectorSource>]
   [-ConnectorType <TenantConnectorType>]
   [-EFSkipIPs <MultiValuedProperty>]
   [-EFSkipLastIP <Boolean>]
   [-EFSkipMailGateway <MultiValuedProperty>]
   [-EFTestMode <Boolean>]
   [-EFUsers <MultiValuedProperty>]
   [-Enabled <Boolean>]
   [-Name <String>]
   [-RequireTls <Boolean>]
   [-RestrictDomainsToCertificate <Boolean>]
   [-RestrictDomainsToIPAddresses <Boolean>]
   [-ScanAndDropRecipients <MultiValuedProperty>]
   [-SenderDomains <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

Set-InboundConnector "Contoso Inbound Connector" -RequireTls $true -TlsSenderCertificateName contoso.com

Con questo esempio vengono apportate le seguenti modifiche di configurazione al connettore in entrata esistente denominato Contoso.com Inbound Connector.

Richiesta della trasmissione TLS per tutti i messaggi in arrivo sul connettore.

Richiesta dell'utilizzo del certificato TLS per crittografare le comunicazioni contenenti il nome di dominio contoso.com.

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 una categoria per i domini che vengono gestiti dal connettore. Di seguito sono riportati alcuni dei valori validi per questo parametro.

  • Partner: il connettore gestisce i domini esterni all'organizzazione.
  • OnPremises: il connettore gestisce i domini utilizzati dall'organizzazione 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

-Identity

Il parametro Identity consente di specificare il connettore in entrata che si desidera modificare.

Type:InboundConnectorIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
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:Named
Default value:None
Required:False
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:False
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 remoti da cui il connettore accetta i messaggi. Gli indirizzi IPv6 non sono supportati. 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 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

-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. Questo parametro funziona solo per il flusso di posta tra due organizzazioni di Microsoft 365, quindi non vengono usati altri parametri.

Per immettere più valori e sovrascrivere le voci esistenti, usare la sintassi seguente: Value1,Value2,...ValueN. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN".

Per aggiungere o rimuovere uno o più valori senza influire sulle voci esistenti, usare la sintassi seguente: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

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.