New-MailContact
Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.
Utilizzare il cmdlet New-MailContact per creare contatti di posta elettronica.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
New-MailContact
-Name <String>
-ExternalEmailAddress <ProxyAddress>
[-Alias <String>]
[-ArbitrationMailbox <MailboxIdParameter>]
[-Confirm]
[-DisplayName <String>]
[-DomainController <Fqdn>]
[-FirstName <String>]
[-Initials <String>]
[-LastName <String>]
[-MacAttachmentFormat <MacAttachmentFormat>]
[-MessageBodyFormat <MessageBodyFormat>]
[-MessageFormat <MessageFormat>]
[-ModeratedBy <MultiValuedProperty>]
[-ModerationEnabled <Boolean>]
[-OrganizationalUnit <OrganizationalUnitIdParameter>]
[-PrimarySmtpAddress <SmtpAddress>]
[-SendModerationNotifications <TransportModerationNotificationFlags>]
[-UsePreferMessageFormat <Boolean>]
[-WhatIf]
[<CommonParameters>]
Descrizione
È 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-MailContact -Name "Chris Ashton" -ExternalEmailAddress "chris@tailspintoys.com"
In questo esempio viene creato un nuovo contatto di posta elettronica denominato Chris Ashton.
Parametri
-Alias
Il parametro Alias consente di specificare l'alias di Exchange (noto anche come alias di posta elettronica) 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 preceduti da caratteri di escape (ad esempio
-Alias what`'snew
) o dall'intero valore racchiuso tra virgolette singole (ad esempio,-Alias 'what'snew'
). Il & carattere non è supportato nel valore Alias per la sincronizzazione di Azure AD Connect. - I punti (.) devono essere racchiusi tra altri caratteri validi,
help.desk
ad esempio . - 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 usato per generare l'indirizzo di posta elettronica primario (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 oe
in nell'indirizzo di posta elettronica primario.
Se non si usa il parametro Alias quando si crea un destinatario, il valore di un parametro obbligatorio diverso viene usato per il valore della proprietà Alias:
- Destinatari con account utente ,ad esempio cassette postali utente e utenti di posta elettronica: viene usato il lato sinistro del parametro MicrosoftOnlineServicesID o UserPrincipalName. Ad esempio, restituisce helpdesk@contoso.onmicrosoft.com il valore
helpdesk
della proprietà Alias . - Destinatari senza account utente(ad esempio cassette postali della sala, contatti di posta elettronica e gruppi di distribuzione): viene usato il valore del parametro Name. Gli spazi vengono rimossi e i caratteri non supportati vengono convertiti in punti interrogativi (?).
Se si modifica il valore Alias di un destinatario esistente, l'indirizzo di posta elettronica primario viene aggiornato automaticamente solo negli ambienti in cui il destinatario è soggetto a criteri di indirizzo di posta elettronica (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 elettronica o di un utente di posta elettronica.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-ArbitrationMailbox
Questo parametro è disponibile solo in Exchange locale.
Il parametro ArbitrationMailbox consente di specificare la cassetta postale di arbitrato utilizzata per la gestione del processo di moderazione per il destinatario. È possibile utilizzare qualsiasi valore che identifichi la cassetta postale di arbitrato in modo univoco. Ad esempio:
- Nome
- Alias
- Nome distinto (DN)
- Nome distinto (DN)
- Dominio\nomeutente
- Indirizzo di posta elettronica
- GUID
- LegacyExchangeDN
- SamAccountName
- ID utente o Nome entità utente (UPN)
Type: | MailboxIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-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 Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-DisplayName
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 (").
Se non si utilizza il parametro DisplayName, il valore del parametro Name viene utilizzato per il nome visualizzato.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-DomainController
Questo parametro è disponibile solo in Exchange locale.
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.
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ExternalEmailAddress
Il parametro ExternalEmailAddress consente di specificare l'indirizzo di posta elettronica di destinazione del contatto di posta elettronica 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 l'indirizzo di posta elettronica primario su un valore diverso. Per impostazione predefinita, questo valore viene utilizzato come indirizzo di posta elettronica principale del contatto di posta elettronica o dell'utente di posta elettronica.
Type: | ProxyAddress |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-FirstName
Il parametro FirstName consente di specificare il nome dell'utente.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Initials
Il parametro Initials consente di specificare le iniziali del secondo nome dell'utente.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-LastName
Il parametro LastName consente di specificare il cognome dell'utente.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-MacAttachmentFormat
Il parametro MacAttachmentFormat consente di specificare il formato di allegato del sistema operativo Apple Macintosh da utilizzare per i messaggi inviati al contatto di posta elettronica o all'utente di posta elettronica. I valori validi sono:
- BinHex (questo è il valore predefinito)
- Uuencode
- AppleSingle
- AppleDouble
I parametri MacAttachmentFormat e MessageFormat sono interdipendenti:
- MessageFormat è Text: MacAttachmentFormat può essere BinHex o UuEncode.
- MessageFormat è Mime: MacAttachmentFormat può essere BinHex, AppleSingle o AppleDouble.
Type: | MacAttachmentFormat |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-MessageBodyFormat
Il parametro MessageBodyFormat consente di specificare il formato del corpo del messaggio per i messaggi inviati al contatto di posta elettronica o all'utente di posta elettronica. I valori validi sono:
- Testo
- Html
- Html
I parametri MessageFormat e MessageBodyFormat sono interdipendenti:
- MessageFormat è Mime: MessageBodyFormat può essere Text, Html o TextAndHtml.
- MessageFormat è Text: MessageBodyFormat può essere solo Text.
Type: | MessageBodyFormat |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-MessageFormat
Il parametro MessageBodyFormat consente di specificare il formato del corpo del messaggio per i messaggi inviati al contatto di posta elettronica o all'utente di posta elettronica. I valori validi sono:
- Testo
- Html
- Html
I parametri MessageFormat e MessageBodyFormat sono interdipendenti:
- MessageFormat è Mime: MessageBodyFormat può essere Text, Html o TextAndHtml.
- MessageFormat è Text: MessageBodyFormat può essere solo Text.
Type: | MessageFormat |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-ModeratedBy
Il parametro ModeratedBy consente di specificare uno o più moderatori per questo contatto di posta. Un moderatore approva i messaggi inviati al contatto di posta elettronica prima che i messaggi vengono recapitati. Un moderatore deve essere una cassetta postale, un utente di posta o un contatto di posta dell'organizzazione. È possibile utilizzare qualsiasi valore che identifichi il moderatore in modo univoco. Ad esempio:
- Nome
- Alias
- Nome distinto (DN)
- Nome distinto (DN)
- Nome distinto canonico
- GUID
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN"
.
È necessario utilizzare questo parametro per specificare almeno un moderatore quando si imposta il parametro ModerationEnabled sul valore $true.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-ModerationEnabled
Il parametro ModerationEnabled specifica se la moderazione è abilitata per questo destinatario. I valori validi sono i seguenti:
- $true: la moderazione è abilitata per questo destinatario. I messaggi inviati a questo destinatario devono essere approvati da un moderatore prima del recapito dei messaggi.
- $false: la moderazione è disabilitata per questo destinatario. I messaggi inviati a questo destinatario vengono recapitati senza l'approvazione di un moderatore. Questo è il valore predefinito.
Usare il parametro ModeratedBy per specificare i moderatori.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Name
Il parametro Name consente di specificare il nome univoco del contatto di posta. La lunghezza massima è 64 caratteri. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").
Questo valore viene utilizzato anche per la proprietà DisplayName se non si utilizza il parametro DisplayName.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-OrganizationalUnit
Il parametro OrganizationalUnit consente di specificare il percorso in Active Directory in cui viene creato il nuovo contatto.
L'input valido per questo parametro è un'unità organizzativa o un dominio restituito dal cmdlet Get-OrganizationalUnit. È possibile utilizzare qualsiasi valore che identifichi l'unità organizzativa o il dominio in modo univoco. Ad esempio:
- Nome
- Nome
- Nome distinto (DN)
- GUID
Type: | OrganizationalUnitIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-PrimarySmtpAddress
Questo parametro è disponibile solo in Exchange locale.
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.
Type: | SmtpAddress |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-SendModerationNotifications
Le connessioni client vengono inviate tramite proxy dai servizi Accesso client ai servizi back-end sui server Cassette postali remoti o locali. I valori validi sono:
- Sempre: notifica a tutti i mittenti quando i loro messaggi non sono approvati. Questo è il valore predefinito.
- Always: notificare a tutti i mittenti che i relativi messaggi non sono approvati. Questo è il valore predefinito.
- Internal: notificare ai mittenti dell'organizzazione solo i messaggi non approvati.
Questo parametro è significativo solo quando la moderazione è abilitata (il parametro ModerationEnabled ha il valore $true).
Type: | TransportModerationNotificationFlags |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-UsePreferMessageFormat
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 o al contatto di posta elettronica usano il formato del messaggio configurato per l'utente o il contatto di posta elettronica.
- $false: i messaggi inviati all'utente o al contatto di posta elettronica 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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, 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 Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, 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.