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.