New-MailContact (RTM)
Si applica a: Exchange Server 2007
Ultima modifica dell'argomento: 2007-06-05
È possibile utilizzare il comando New-MailContact per creare un nuovo contatto abilitato alla posta.
Sintassi
New-MailContact -Name <String> -ExternalEmailAddress <ProxyAddress> -OrganizationalUnit <OrganizationalUnitIdParameter> [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-MacAttachmentFormat <BinHex | UuEncode | AppleSingle | AppleDouble>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-TemplateInstance <PSObject>] [-UsePreferMessageFormat <$true | $false>]
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 Account Operator per i contenitori applicabili di Active Directory
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. |
Nome |
Obbligatorio |
System.String |
Nome comune del contatto di posta. |
OrganizationalUnit |
Obbligatorio |
Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter |
L'unità organizzativa a cui viene aggiunto il nuovo contatto. Esempio: redmond.contoso.com/contacts. |
Alias |
Facoltativo |
System.String |
Alias del contatto di posta. |
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 le modifiche alla configurazione in Active Directory, includere nel comando il parametro DomainController. |
FirstName |
Facoltativo |
System.String |
Nome del contatto di posta. |
Iniziali |
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 allegato per il sistema operativo Apple Macintosh per i messaggi inviati al contatto di posta elettronica. I valori validi per questo parametro sono:
Per impostazione predefinita, questo parametro è impostato su BinHex. I valori accettati per il parametro MacAttachmentFormat dipendono dal parametro MessageFormat. Se il parametro MessageFormat è impostato su Text, è possibile utilizzare solo i valori BinHex o UUENCODE per questo parametro. Se il parametro MessageFormat è impostato su Mime, è possibile utilizzare solo i valori BinHex, AppleSingle o AppleDouble per questo parametro. |
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 elettronica. I valori validi per questo parametro sono:
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 TextAndHtml, è necessario anche impostare il parametro MessageFormat su Mime. |
MessageFormat |
Facoltativo |
Microsoft.Exchange.Data.Directory.Recipient.MessageFormat |
Il parametro MessageFormat consente di specificare il formato messaggio per i messaggi inviati al contatto di posta elettronica. I valori validi per questo parametro sono:
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 qualunque 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 anche modificare il parametro MessageBodyFormat e impostarlo su Text. |
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 |
Se questo parametro è impostato su true, viene specificato che le impostazioni di formato dei messaggi preferiti del destinatario avranno la priorità sulle impostazioni globali per la posta inviata a questo utente. |
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"