Enable-MailContact
Questo cmdlet è disponibile solo in Exchange locale.
Utilizzare il cmdlet Enable-MailContact per aggiungere funzionalità di posta elettronica ai contatti che non sono già abilitati alla posta elettronica.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Default (Impostazione predefinita)
Enable-MailContact
[-Identity] <ContactIdParameter>
-ExternalEmailAddress <ProxyAddress>
[-Alias <String>]
[-Confirm]
[-DisplayName <String>]
[-DomainController <Fqdn>]
[-MacAttachmentFormat <MacAttachmentFormat>]
[-MessageBodyFormat <MessageBodyFormat>]
[-MessageFormat <MessageFormat>]
[-PrimarySmtpAddress <SmtpAddress>]
[-UsePreferMessageFormat <Boolean>]
[-WhatIf]
[<CommonParameters>]
Descrizione
Il cmdlet Enable-MailContact consente ai contatti esistenti di usare l'account di posta elettronica aggiungendo gli attributi di posta elettronica necessari per Exchange. I contatti di posta elettronica sono visibili agli altri cmdlet *-MailContact.
È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Anche se questo articolo elenca tutti i parametri per il cmdlet, si potrebbe non avere accesso ad alcuni parametri se non sono 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
Enable-MailContact -Identity Roland -ExternalEmailAddress "roland@tailspintoys.com"
In questo esempio, viene abilitato alla posta elettronica un contatto esistente che non dispone di tale funzionalità.
Parametri
-Alias
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Il parametro Alias consente di specificare l'alias di Exchange (noto anche come nome alternativo della posta) per il destinatario. Questo valore consente di identificare il destinatario come oggetto abilitato alla posta elettronica e non deve essere confuso con più indirizzi di posta elettronica dello stesso destinatario (noti anche come indirizzi proxy). Un destinatario può disporre di un solo valore Alias. La lunghezza massima è 64 caratteri.
Il valore alias può contenere lettere, numeri e i caratteri seguenti:
- !, #, %, *, +, -, /, =, ?, ^, _ e ~.
- $, &, ', ', {, } e | devono essere sottoposti a escape (ad esempio
-Alias what`'snew) o l'intero valore racchiuso tra virgolette singole (ad esempio,-Alias 'what'snew'). Il carattere & non è supportato nel valore Alias per la sincronizzazione Microsoft Entra Connect. - I punti (.) devono essere racchiusi da altri caratteri validi (ad esempio,
help.desk). - Caratteri Unicode da U+00A1 a U+00FF.
Quando si crea un destinatario senza specificare un indirizzo di posta elettronica, il valore Alias specificato viene utilizzato per generare l'indirizzo di posta elettronica principale (alias@domain). I caratteri Unicode supportati sono mappati per adattarsi ai caratteri di testo US-ASCII in modo ottimale. Ad esempio, U+00F6 (ö) viene modificato nell'indirizzo oe di posta elettronica principale.
Se non si usa il parametro Alias quando si crea un destinatario, per il valore della proprietà Alias viene usato il valore di un parametro obbligatorio diverso:
- Destinatari con account utente, ad esempio cassette postali e utenti di posta elettronica: viene usato il lato sinistro del parametro MicrosoftOnlineServicesID o UserPrincipalName. Ad esempio, helpdesk@contoso.onmicrosoft.com restituisce il valore
helpdeskdella proprietà Alias . - Destinatari senza account utente (ad esempio, cassette postali della sala, contatti di posta e gruppi di distribuzione): viene utilizzato il valore del parametro Name. Gli spazi vengono rimossi e i caratteri non supportati vengono convertiti in punti interrogativi (?).
Se modifichi il valore dell'alias di un destinatario esistente, l'indirizzo e-mail principale viene aggiornato automaticamente solo negli ambienti in cui il destinatario è soggetto a criteri per gli indirizzi e-mail (la proprietà EmailAddressPolicyEnabled è True per il destinatario).
Il parametro Alias non genera o aggiorna mai l'indirizzo di posta elettronica principale di un contatto di posta o di un utente di posta elettronica.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Confirm
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. Il modo in cui questa opzione influisce sul cmdlet varia se il cmdlet richiede o meno una conferma prima di procedere.
- I cmdlet distruttivi (ad esempio, i cmdlet Remove-*) dispongono di una pausa incorporata che impone all'utente 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 dispone di una pausa incorporata. Per questi cmdlet, se si specifica l'opzione Confirm senza un valore, viene introdotta una pausa che impone di confermare il comando prima di procedere.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | cfr |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-DisplayName
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Il parametro DisplayName consente di specificare il nome visualizzato del contatto di posta. Il nome visualizzato è visibile nell'interfaccia di amministrazione di Exchange e negli elenchi di indirizzi. La lunghezza massima è 256 caratteri. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-DomainController
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, dc01.contoso.com.
Proprietà dei parametri
| Tipo: | Fqdn |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ExternalEmailAddress
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Il parametro ExternalEmailAddress consente di specificare l'indirizzo di posta elettronica di destinazione del contatto o dell'utente di posta elettronica. Per impostazione predefinita, questo valore viene usato come indirizzo di posta elettronica principale del contatto di posta elettronica o dell'utente di posta elettronica.
Negli ambienti locali è possibile usare il parametro PrimarySMTPAddress per impostare un valore diverso per l'indirizzo di posta elettronica principale. Per impostazione predefinita, questo valore viene utilizzato come indirizzo di posta elettronica principale del contatto di posta elettronica o dell'utente di posta elettronica.
Proprietà dei parametri
| Tipo: | ProxyAddress |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Identity
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Il parametro Identity consente di specificare il contatto non abilitato alla posta elettronica per il quale si desidera abilitare la funzionalità. È possibile utilizzare qualsiasi valore che identifichi il contatto in modo univoco. Ad esempio:
- Nome
- Nome distinto (DN)
- Nome distinto (DN)
- GUID
Proprietà dei parametri
| Tipo: | ContactIdParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 1 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-MacAttachmentFormat
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Il parametro MacAttachmentFormat consente di specificare il formato di allegato del sistema operativo Apple Macintosh da utilizzare per i messaggi inviati al contatto o all'utente di posta elettronica. I valori validi sono:
- BinHex (valore predefinito)
- UuEncode
- MelaSingolo
- MelaDoppia
I parametri MacAttachmentFormat e MessageFormat sono interdipendenti:
- MessageFormat è un testo: MacAttachmentFormat può essere BinHex o UuEncode.
- MessageFormat è Mime: MacAttachmentFormat può essere BinHex, AppleSingle o AppleDouble.
Proprietà dei parametri
| Tipo: | MacAttachmentFormat |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-MessageBodyFormat
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Il parametro MessageBodyFormat consente di specificare il formato del corpo del messaggio per i messaggi inviati al contatto o all'utente di posta elettronica. I valori validi sono:
- Testo
- HTML
- TextAndHtml (valore predefinito)
I parametri MessageFormat e MessageBodyFormat sono interdipendenti:
- MessageFormat è Mime: MessageBodyFormat può essere Text, Html o TextAndHtml.
- MessageFormat è un valore di testo: MessageBodyFormat può essere solo testo.
Proprietà dei parametri
| Tipo: | MessageBodyFormat |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-MessageFormat
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Il parametro MessageFormat consente di specificare il formato del messaggio per i messaggi inviati al contatto o all'utente di posta elettronica. I valori validi sono:
- Testo
- Mime (valore predefinito)
I parametri MessageFormat e MessageBodyFormat sono interdipendenti:
- MessageFormat è Mime: MessageBodyFormat può essere Text, Html o TextAndHtml.
- MessageFormat è un valore di testo: MessageBodyFormat può essere solo testo.
Pertanto, se si desidera cambiare il parametro MessageFormat da Mime a Text, è necessario modificare anche il parametro MessageBodyFormat in Text.
Proprietà dei parametri
| Tipo: | MessageFormat |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-PrimarySmtpAddress
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Il parametro PrimarySmtpAddress consente di specificare l'indirizzo di posta elettronica primario di risposta utilizzato per il destinatario.
Per impostazione predefinita, l'indirizzo primario è lo stesso del valore del parametro ExternalEmailAddress.
Se si utilizza il parametro PrimarySmtpAddress per specificare l'indirizzo di posta elettronica principale, il comando consente di impostare la proprietà EmailAddressPolicyEnabled del contatto di posta su False, che indica che gli indirizzi di posta elettronica del contatto di posta non vengono aggiornati automaticamente dai criteri degli indirizzi di posta elettronica. Si consiglia di non impostare l'indirizzo di posta elettronica principale su un valore diverso da ExternalEmailAddress a meno che non ci si trovi in uno scenario con più foreste.
Proprietà dei parametri
| Tipo: | SmtpAddress |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-UsePreferMessageFormat
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
UsePreferMessageFormat specifica se le impostazioni del formato del messaggio configurate per l'utente di posta elettronica o il contatto di posta elettronica sostituiscono le impostazioni globali configurate per il dominio remoto o configurate dal mittente del messaggio. I valori validi sono i seguenti:
- $true: i messaggi inviati all'utente di posta o al contatto di posta utilizzano il formato del messaggio configurato per l'utente di posta o il contatto di posta.
- $false: I messaggi inviati all'utente di posta o al contatto di posta usano il formato del messaggio configurato per il dominio remoto (il dominio remoto predefinito o un dominio remoto specifico) o configurato dal mittente del messaggio. Questo è il valore predefinito.
Proprietà dei parametri
| Tipo: | Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-WhatIf
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
L'opzione WhatIf mostra le operazioni eseguite dal comando senza apportare modifiche. Con questa opzione non è necessario specificare alcun valore.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | wi |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.
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.