Set-OutboundConnector
Questo cmdlet è disponibile solamente nel servizio basato sul cloud.
Usare il cmdlet Set-OutboundConnector per modificare un connettore in uscita esistente nell'organizzazione basata su cloud.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Set-OutboundConnector
[-Identity] <OutboundConnectorIdParameter>
[-AllAcceptedDomains <Boolean>]
[-CloudServicesMailEnabled <Boolean>]
[-Comment <String>]
[-Confirm]
[-ConnectorSource <TenantConnectorSource>]
[-ConnectorType <TenantConnectorType>]
[-Enabled <Boolean>]
[-IsTransportRuleScoped <Boolean>]
[-IsValidated <Boolean>]
[-LastValidationTimestamp <DateTime>]
[-Name <String>]
[-RecipientDomains <MultiValuedProperty>]
[-RouteAllMessagesViaOnPremises <Boolean>]
[-SenderRewritingEnabled <Boolean>]
[-SmartHosts <MultiValuedProperty>]
[-TestMode <Boolean>]
[-TlsDomain <SmtpDomainWithSubdomains>]
[-TlsSettings <TlsAuthLevel>]
[-UseMXRecord <Boolean>]
[-ValidationRecipients <String[]>]
[-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
Set-OutboundConnector "Contoso Outbound Connector" -UseMxRecord $false -SmartHosts 192.168.0.1Questo esempio modifica le impostazioni del connettore in uscita denominato Contoso Outbound Connector per instradare ad uno smart host all'indirizzo IP 192.168.0.1.
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 per i connettori creati manualmente 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 |
-Identity
Il parametro Identity indica il connettore che si desidera modificare. È possibile utilizzare qualsiasi valore che identifichi il connettore in maniera univoca. Ad esempio:
- Nome
- Nome distinto (DN)
- GUID
| Type: | OutboundConnectorIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| 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 |
-IsValidated
Il parametro IsValidated specifica se il connettore in uscita è stato convalidato. I valori validi sono:
- $true: il connettore è stato convalidato,
- $false: il connettore non è stato convalidato. Questo è il valore predefinito.
Usare il cmdlet Validate-OutboundConnector per convalidare 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 |
-LastValidationTimestamp
Il parametro LastValidationTimestamp specifica la data/ora in cui è stato convalidato il connettore in uscita.
Per specificare un valore data/ora per questo parametro, utilizzare una delle opzioni seguenti:
- Specificare il valore di data/ora in formato UTC: ad esempio, "2021-05-06 14:30:00z".
- Specificare il valore di data/ora come formula che converte la data/ora nel fuso orario locale in formato UTC: ad esempio,
(Get-Date "5/6/2021 9:30 AM").ToUniversalTime(). Per altre informazioni, vedere Get-Date.
Usare il cmdlet Validate-OutboundConnector per convalidare il connettore.
| Type: | DateTime |
| 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: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-RecipientDomains
Il parametro RecipientDomains consente di specificare il dominio a cui il connettore in uscita instrada 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 inviati da questo connettore vengono prima indirizzati attraverso il sistema di posta elettronica locale. 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 |
-ValidationRecipients
Il parametro ValidationRecipients specifica gli indirizzi di posta elettronica dei destinatari di convalida per il connettore in uscita. È possibile indicare più indirizzi di posta elettronica separati da virgole.
| Type: | String[] |
| 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.