New-MailContact

  • Articolo

 

Si applica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Ultima modifica dell'argomento: 2009-05-14

È possibile utilizzare il comando New-MailContact per creare un nuovo contatto abilitato alla posta.

Sintassi

New-MailContact -Name <String> -ExternalEmailAddress <ProxyAddress> [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-MacAttachmentFormat <BinHex | UuEncode | AppleSingle | AppleDouble>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-PrimarySmtpAddress <SmtpAddress>] [-TemplateInstance <PSObject>] [-UsePreferMessageFormat <$true | $false>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Il comando New-MailContact consente di creare un nuovo oggetto contatto per la posta in Microsoft Active Directory e quindi di abilitarlo alla posta.

Per eseguire il cmdlet New-MailContact, è necessario utilizzare un account che disponga della seguente delega:

  • Ruolo Exchange Recipient Administrator

  • Ruolo operatore account per i contenitori Active Directory applicabili

Per ulteriori informazioni sulle autorizzazioni, sulla delega dei ruoli e sui diritti necessari per l'amministrazione di Exchange Server 2007, vedere Considerazioni sulle autorizzazioni.

Parametri

Parametro Obbligatorio Tipo Descrizione

ExternalEmailAddress

Obbligatorio

Microsoft.Exchange.Data.ProxyAddress

Indirizzo di posta elettronica di destinazione.

Name

Obbligatorio

System.String

Nome comune del contatto di posta.

Alias

Facoltativo

System.String

Alias del contatto di posta.

Confirm

Facoltativo

System.Management.Automation.SwitchParameter

Il parametro Confirm determina l'interruzione dell'elaborazione e richiede che l'utente, prima che l'elaborazione continui, confermi l'operazione che verrà eseguita dal comando. Non è necessario specificare alcun valore con il parametro Confirm.

DisplayName

Facoltativo

System.String

Il nome visualizzato in Microsoft Outlook per il contatto di posta.

DomainController

Facoltativo

Microsoft.Exchange.Data.Fqdn

Per specificare il nome di dominio completo (FQDN) del controller di dominio che consente di scrivere la modifica alla configurazione in Active Directory, includere nel comando il parametro DomainController.

FirstName

Facoltativo

System.String

Nome del contatto di posta.

Initials

Facoltativo

System.String

Iniziali del contatto di posta.

LastName

Facoltativo

System.String

Cognome del contatto di posta.

MacAttachmentFormat

Facoltativo

Microsoft.Exchange.Data.Directory.Recipient.MacAttachmentFormat

Il parametro MacAttachmentFormat consente di specificare il formato degli allegati provenienti dal sistema operativo Apple Macintosh per i messaggi inviati al contatto di posta. I valori validi per questo parametro sono:

  • BinHex

  • UUENCODE

  • AppleSingle

  • AppleDouble

Per impostazione predefinita, questo parametro è impostato su BinHex.

I valori accettabili per il parametro MacAttachmentFormat dipendono dal parametro MessageFormat. Se il parametro MessageFormat è impostato su Text, i valori relativi utilizzabili sono solo BinHex o UUENCODE. Se il parametro MessageFormat è impostato su Mime, i valori relativi utilizzabili sono solo BinHex, AppleSingle o AppleDouble.

MessageBodyFormat

Facoltativo

Microsoft.Exchange.Data.Directory.Recipient.MessageBodyFormat

Il parametro MessageBodyFormat consente di specificare il formato del corpo del messaggio per i messaggi inviati al contatto di posta. I valori validi per questo parametro sono:

  • Text

  • Html

  • TextAndHtml

Per impostazione predefinita, questo parametro è impostato su TextAndHtml.

I parametri MessageFormat e MessageBodyFormat sono interdipendenti. Se il parametro MessageFormat è impostato su Mime, il parametro MessageBodyFormat può essere impostato su qualunque valore valido. Tuttavia, se il parametro MessageFormat è impostato su Text, il parametro MessageBodyFormat può essere impostato solo su Text. Pertanto, se si desidera impostare questo parametro su Html o su TextAndHtml, è necessario impostare anche il parametro MessageFormat su Mime.

MessageFormat

Facoltativo

Microsoft.Exchange.Data.Directory.Recipient.MessageFormat

Il parametro MessageFormat consente di specificare il formato dei messaggi inviati al contatto di posta.

I valori validi per questo parametro sono:

  • Text

  • MIME

Per impostazione predefinita, questo parametro è impostato su Mime.

I parametri MessageFormat e MessageBodyFormat sono interdipendenti. Se il parametro MessageFormat è impostato su Mime, il parametro MessageBodyFormat può essere impostato su qualsiasi valore valido. Tuttavia, se il parametro MessageFormat è impostato su Text, il parametro MessageBodyFormat può essere impostato solo su Text. Pertanto, se si desidera modificare il parametro MessageFormat da Mime a Text, è necessario modificare anche il parametro MessageBodyFormat impostandolo su Text.

OrganizationalUnit

Facoltativo

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

L'unità organizzativa a cui viene aggiunto il nuovo contatto. Esempio: redmond.contoso.com/contacts.

PrimarySmtpAddress

Facoltativo

Microsoft.Exchange.Data.SmtpAddress

Questo parametro consente di specificare l'indirizzo SMTP primario per il contatto di posta. Per impostazione predefinita, l'indirizzo SMTP primario viene generato in base ai criteri per gli indirizzi di posta elettronica predefiniti. Se si utilizza questo parametro per specificare un indirizzo SMTP primario, il cmdlet imposterà l'attributo EmailAddressPolicyEnabled del contatto di posta su $false e gli indirizzi di posta elettronica del contatto non verranno aggiornati automaticamente in base ai criteri per gli indirizzi di posta elettronica.

TemplateInstance

Facoltativo

System.Management.Automation.PSObject

Quando per questo parametro viene specificato un oggetto esistente, il comando utilizza la configurazione dell'oggetto per crearne un duplicato esatto in un server locale o di destinazione.

UsePreferMessageFormat

Facoltativo

System.Boolean

Quando è impostato su True, questo parametro consente di specificare che le impostazioni predefinite di formato dei messaggi dei destinatari sovrascrivano le impostazioni globali della posta elettronica inviata all'utente.

UseRusServer

Facoltativo

System.String
noteNota:
Questo parametro è disponibile solo in Exchange 2007 SP2.

Il parametro UseRusServer consente al comando di utilizzare il server Cassette postali specificato su cui è in esecuzione il Servizio elenco di indirizzi per ottenere e impostare la cassetta postale e gli attributi dell'utente di Active Directory.

Il Servizio elenco indirizzi è un componente del servizio Supervisore sistema di Exchange. Il Servizio elenco indirizzi consente di creare e gestire i valori degli attributi specifici di Exchange in Active Directory. È possibile utilizzare il Servizio elenco indirizzi per aggiornare gli oggetti destinatario in un dominio utilizzando informazioni specifiche, come l'appartenenza a un elenco di indirizzi e gli indirizzi di posta elettronica.

WhatIf

Facoltativo

System.Management.Automation.SwitchParameter

Il parametro WhatIf consente al comando di simulare le azioni da intraprendere sull'oggetto. Utilizzando il parametro WhatIf, è possibile visualizzare quali sono le modifiche che verrebbero apportate senza applicarle. Non è necessario specificare alcun valore con il parametro WhatIf.

Tipi di input

Tipi restituiti

Errori

Errore Descrizione

Eccezioni

Eccezioni Descrizione

Esempio

Nell'esempio riportato di seguito, il comando New-MailContact viene utilizzato per creare un nuovo contatto abilitato alla posta.

New-MailContact -Name "Ted Bremer" -ExternalEmailAddress "ted@tailspintoys.com" -OrganizationalUnit "Marketing"