Condividi tramite


New-MailContact

Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni potrebbero essere esclusivi per un ambiente o l'altro.

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

Default (impostazione predefinita).

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. Anche se questo articolo elenca tutti i parametri per il cmdlet, è possibile che non si abbia accesso ad alcuni parametri se non sono inclusi nelle autorizzazioni assegnate all'utente. 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

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

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 | deve essere preceduto 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 Microsoft Entra Connect.
  • I punti (.) devono essere racchiusi tra altri caratteri validi, help.deskad 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 helpdeskdella 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.

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

-ArbitrationMailbox

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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\Nome utente
  • Indirizzo di posta elettronica
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID utente o Nome entità utente (UPN)

Proprietà dei parametri

Tipo:MailboxIdParameter
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 Online, Exchange Online Protection

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-*) 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, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente 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 Online, Exchange Online Protection

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.

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

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.

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 Online, Exchange Online Protection

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.

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

-FirstName

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

Il parametro FirstName consente di specificare il nome dell'utente.

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

-Initials

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

Il parametro Initials consente di specificare le iniziali del secondo nome dell'utente.

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

-LastName

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

Il parametro LastName consente di specificare il cognome dell'utente.

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

-MacAttachmentFormat

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

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 (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.

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 Online, Exchange Online Protection

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
  • TextAndHtml (valore predefinito)

I parametri MessageFormat e MessageBodyFormat sono interdipendenti:

  • MessageFormat è Mime: MessageBodyFormat può essere Text, Html o TextAndHtml.
  • MessageFormat è Text: MessageBodyFormat può essere solo Text.

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 Online, Exchange Online Protection

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
  • TextAndHtml (valore predefinito)

I parametri MessageFormat e MessageBodyFormat sono interdipendenti:

  • MessageFormat è Mime: MessageBodyFormat può essere Text, Html o TextAndHtml.
  • MessageFormat è Text: MessageBodyFormat può essere solo 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

-ModeratedBy

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

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 richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".

È necessario utilizzare questo parametro per specificare almeno un moderatore quando si imposta il parametro ModerationEnabled sul valore $true.

Proprietà dei parametri

Tipo:MultiValuedProperty
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

-ModerationEnabled

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

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 valore è il valore predefinito.

Usare il parametro ModeratedBy per specificare i moderatori.

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

-Name

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

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.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:1
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-OrganizationalUnit

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

Il parametro OrganizationalUnit specifica 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

Proprietà dei parametri

Tipo:OrganizationalUnitIdParameter
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

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.

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

-SendModerationNotifications

Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

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 valore è 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).

Proprietà dei parametri

Tipo:TransportModerationNotificationFlags
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 Online, Exchange Online Protection

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 valore è 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 Online, Exchange Online Protection

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.

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.