Condividi tramite

Set-MailContact

  • Articolo

 

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

Ultima modifica dell'argomento: 2011-01-26

Il cmdlet Set-MailContact consente di modificare un contatto abilitato alla posta elettronica esistente nel servizio directory di Active Directory.

Sintassi

Set-MailContact -Identity <MailContactIdParameter> [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-CreateDTMFMap <$true | $false>] [-CustomAttribute1 <String>] [-CustomAttribute10 <String>] [-CustomAttribute11 <String>] [-CustomAttribute12 <String>] [-CustomAttribute13 <String>] [-CustomAttribute14 <String>] [-CustomAttribute15 <String>] [-CustomAttribute2 <String>] [-CustomAttribute3 <String>] [-CustomAttribute4 <String>] [-CustomAttribute5 <String>] [-CustomAttribute6 <String>] [-CustomAttribute7 <String>] [-CustomAttribute8 <String>] [-CustomAttribute9 <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-EmailAddresses <ProxyAddressCollection>] [-EmailAddressPolicyEnabled <$true | $false>] [-Extensions <MultiValuedProperty>] [-ExternalEmailAddress <ProxyAddress>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IgnoreDefaultScope <SwitchParameter>] [-MacAttachmentFormat <BinHex | AppleSingle | AppleDouble>] [-MaxReceiveSize <Unlimited>] [-MaxRecipientPerMessage <Unlimited>] [-MaxSendSize <Unlimited>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SecondaryAddress <String>] [-SecondaryDialPlan <UMDialPlanIdParameter>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-UseMapiRichTextFormat <Never | Always | UseDefaultSettings>] [-UsePreferMessageFormat <$true | $false>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Set-MailContact [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-CreateDTMFMap <$true | $false>] [-CustomAttribute1 <String>] [-CustomAttribute10 <String>] [-CustomAttribute11 <String>] [-CustomAttribute12 <String>] [-CustomAttribute13 <String>] [-CustomAttribute14 <String>] [-CustomAttribute15 <String>] [-CustomAttribute2 <String>] [-CustomAttribute3 <String>] [-CustomAttribute4 <String>] [-CustomAttribute5 <String>] [-CustomAttribute6 <String>] [-CustomAttribute7 <String>] [-CustomAttribute8 <String>] [-CustomAttribute9 <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-EmailAddresses <ProxyAddressCollection>] [-EmailAddressPolicyEnabled <$true | $false>] [-Extensions <MultiValuedProperty>] [-ExternalEmailAddress <ProxyAddress>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IgnoreDefaultScope <SwitchParameter>] [-Instance <MailContact>] [-MacAttachmentFormat <BinHex | AppleSingle | AppleDouble>] [-MaxReceiveSize <Unlimited>] [-MaxRecipientPerMessage <Unlimited>] [-MaxSendSize <Unlimited>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SecondaryAddress <String>] [-SecondaryDialPlan <UMDialPlanIdParameter>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-UseMapiRichTextFormat <Never | Always | UseDefaultSettings>] [-UsePreferMessageFormat <$true | $false>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Descrizione dettagliata

Il cmdlet Set-MailContact consente di modificare un contatto abilitato alla posta elettronica esistente in Active Directory specificando l'identità del contatto e gli attributi da modificare.

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

  • Ruolo Exchange Recipient Administrator

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Microsoft.Exchange.Configuration.Tasks.MailContactIdParameter

Il parametro Identity accetta uno dei seguenti valori:

  • ADObjectID

  • GUID

  • Nome distinto (DN)

  • Dominio\SamAccountName

  • Nome dell'entità utente (UPN, User principal name)

  • DN legacy

  • Indirizzo di posta elettronica

  • Alias del contatto

AcceptMessagesOnlyFrom

Facoltativo

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

Il parametro AcceptMessagesOnlyFrom specifica gli utenti delle cassette postali e i contatti di posta che possono inviare messaggi di posta elettronica a questo contatto di posta. È inoltre possibile specificare Microsoft Exchange come destinatario valido per il parametro. Se si configura un contatto di posta perché accetti messaggi solo dal destinatario Microsoft Exchange, esso riceverà solo messaggi generati dal sistema.

Il parametro AcceptMessagesOnlyFrom consente di accettare uno dei seguenti valori per i mittenti validi:

  • Nome distinto (DN)

  • Nome canonico

  • GUID

  • Nome

  • Nome visualizzato

  • Alias

  • Exchange DN

  • Indirizzo di posta elettronica SMTP principale

Per impostazione predefinita, questo parametro è vuoto. Questo valore predefinito consente al contatto di posta di accettare i messaggi da tutti i mittenti.

AcceptMessagesOnlyFromDLMembers

Facoltativo

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

Il parametro AcceptMessagesOnlyFromDLMembers consente di specificare i gruppi di distribuzione ai cui membri è consentito inviare messaggi di posta elettronica a questo contatto di posta. È possibile utilizzare uno dei seguenti valori per i gruppi di distribuzione consentiti:

  • Nome distinto (DN)

  • Nome canonico

  • GUID

  • Nome

  • Nome visualizzato

  • Nome distinto legacy di Exchange

  • Indirizzo di posta elettronica SMTP principale

Per impostazione predefinita, questo parametro è vuoto. Questo valore predefinito consente al contatto di posta di accettare i messaggi da tutti i mittenti.

Alias

Facoltativo

System.String

Il parametro Alias consente di specificare l'alias del contatto abilitato alla posta. Un alias può contenere lettere, numeri e i seguenti segni di punteggiatura e simboli:

  • !

  • #

  • $

  • %

  • ^

  • &

  • *

  • +

  • -

  • .

  • /

  • =

  • ?

  • _

  • {

  • }

  • |

  • ~

Confirm

Facoltativo

System.Management.Automation.SwitchParameter

Il parametro Confirm consente di determinare la sospensione dell'elaborazione e di richiedere che l'utente confermi l'operazione che verrà eseguita dal comando prima che l'elaborazione continui. Con il parametro Confirm non è necessario specificare un valore.

CreateDTMFMap

Facoltativo

System.Boolean

Questo parametro consente di specificare una mappa DTMF (Dual Tone Multi-Frequency) da creare per il contatto.

CustomAttribute1

Facoltativo

System.String

Il parametro CustomAttribute1 consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.

CustomAttribute10

Facoltativo

System.String

Il parametro CustomAttribute10 consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.

CustomAttribute11

Facoltativo

System.String

Il parametro CustomAttribute11 consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.

CustomAttribute12

Facoltativo

System.String

Il parametro CustomAttribute12 consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.

CustomAttribute13

Facoltativo

System.String

Il parametro CustomAttribute13 consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.

CustomAttribute14

Facoltativo

System.String

Il parametro CustomAttribute14 consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.

CustomAttribute15

Facoltativo

System.String

Il parametro CustomAttribute15 consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.

CustomAttribute2

Facoltativo

System.String

Il parametro CustomAttribute2 consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.

CustomAttribute3

Facoltativo

System.String

Il parametro CustomAttribute3 consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.

CustomAttribute4

Facoltativo

System.String

Il parametro CustomAttribute4 consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.

CustomAttribute5

Facoltativo

System.String

Il parametro CustomAttribute5 consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.

CustomAttribute6

Facoltativo

System.String

Il parametro CustomAttribute6 consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.

CustomAttribute7

Facoltativo

System.String

Il parametro CustomAttribute7 consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.

CustomAttribute8

Facoltativo

System.String

Il parametro CustomAttribute8 consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.

CustomAttribute9

Facoltativo

System.String

Il parametro CustomAttribute9 consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.

DisplayName

Facoltativo

System.String

Il parametro DisplayName consente di specificare il nome visualizzato dell'utente.

DomainController

Facoltativo

Microsoft.Exchange.Data.Fqdn

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

EmailAddresses

Facoltativo

Microsoft.Exchange.Data.ProxyAddressCollection

Il parametro EmailAddresses consente di specificare l'alias di posta elettronica del contatto di posta. È possibile utilizzare tutti i tipi di indirizzi di posta elettronica di MIcrosoft Exchange 2007 validi. È possibile specificare più valori per il parametro EmailAddresses, sotto forma di elenco delimitato da virgole.

Importante

Exchange 2007 non convalida gli indirizzi personalizzati per una formattazione corretta. È necessario assicurarsi che l'indirizzo personalizzato specificato sia conforme a i requisiti di formato per tale tipo di indirizzo. Poiché gli indirizzi X.400 sono considerati indirizzi personalizzati in Exchange 2007, anch'essi non vengono convalidati. Quindi, è necessario utilizzare la sintassi corretta quando si specificano gli indirizzi X.400.

EmailAddressPolicyEnabled

Facoltativo

System.Boolean

Il parametro EmailAddressPolicyEnabled consente di specificare se gli indirizzi di posta elettronica per la cassetta postale saranno automaticamente aggiornati sulla base dei criteri di indirizzo di posta elettronica definiti.

Extensions

Facoltativo

Microsoft.Exchange.Data.MultiValuedProperty

Questo parametro consente di specificare uno o più numeri di interni per il contatto. Quando il parametro è impostato, tutti gli interni compresi nel dial plan devono essere univoci.

ExternalEmailAddress

Facoltativo

Microsoft.Exchange.Data.ProxyAddress

Il parametro ExternalEmailAddress consente di specificare l'indirizzo di posta elettronica esterno del destinatario.

GrantSendOnBehalfTo

Facoltativo

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

Il parametro GrantSendOnBehalfTo consente di specificare i nomi distinti di destinatari a cui è consentito inviare messaggi per conto di questo contatto.

HiddenFromAddressListsEnabled

Facoltativo

System.Boolean

Il parametro HiddenFromAddressListsEnabled consente di specificare se il contatto viene visualizzato nell'elenco di indirizzi. Se il valore è $true, il contatto non viene visualizzato nell'elenco di indirizzi. Il valore predefinito è $false.

IgnoreDefaultScope

Facoltativo

System.Management.Automation.SwitchParameter

Il parametro IgnoreDefaultScope consente di indicare al comando di ignorare l'impostazione dell'ambito destinatari predefinita di Exchange Management Shell e di utilizzare l'intera foresta come ambito. Ciò consente al comando di accedere agli oggetti di Active Directory che non si trovano correntemente nell'ambito predefinito. L'utilizzo del parametro IgnoreDefaultScope presenta le seguenti restrizioni:

  • Non è possibile utilizzare il parametro DomainController. Il comando utilizzerà automaticamente un server di catalogo globale appropriato.

  • È possibile utilizzare solo il DN per il parametro Identity. Non sono accettate altre forme di identificazione, ad esempio alias o GUID.

Instance

Facoltativo

Microsoft.Exchange.Data.Directory.Management.MailContact

Il parametro Instance consente di trasmettere l'intero oggetto al comando per l'elaborazione. Viene utilizzato principalmente negli script in cui è necessario passare l'intero oggetto al comando.

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:

  • BinHex

  • AppleSingle

  • AppleDouble

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 per questo parametro. Se il parametro MessageFormat è impostato su Mime, è possibile utilizzare solo i valori BinHex, AppleSingle o AppleDouble per questo parametro.

MaxReceiveSize

Facoltativo

Microsoft.Exchange.Data.Unlimited

Il parametro MaxReceiveSize consente di specificare la dimensione massima ricevibile dei messaggi di posta elettronica, da 1 kilobyte (KB) a 2.097.151 KB.

Se non viene specificato alcun valore, il limite viene impostato sul valore massimo.

MaxRecipientPerMessage

Facoltativo

Microsoft.Exchange.Data.Unlimited

Il parametro MaxRecipientPerMessage consente di specificare il numero massimo di destinatari per messaggi proveniente da questo contatto di posta.

MaxSendSize

Facoltativo

Microsoft.Exchange.Data.Unlimited

Il parametro MaxSendSize consente di specificare la dimensione massima inviabile dei messaggi di posta elettronica, da 1 kilobyte (KB) a 2.097.151 KB.

Se non viene specificato alcun valore, il limite viene impostato sul valore massimo.

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:

  • 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 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:

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

Name

Facoltativo

System.String

Il parametro Name consente di specificare il nome del contatto abilitato alla posta.

PrimarySmtpAddress

Facoltativo

Microsoft.Exchange.Data.SmtpAddress

Il parametro PrimarySmtpAddress consente di specificare l'indirizzo di posta elettronica SMTP (Simple Mail Transfer Protocol) primario.

RejectMessagesFrom

Facoltativo

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

Il parametro RejectMessagesFrom consente di specificare i destinatari di cui rifiutare i messaggi.

RejectMessagesFromDLMembers

Facoltativo

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

Il parametro RejectMessagesFromDLMembers consente di specificare i membri della lista di distribuzione di cui rifiutare i messaggi.

RequireSenderAuthenticationEnabled

Facoltativo

System.Boolean

Il parametro RequireSenderAuthenticationEnabled consente di specificare se accettare messaggi solo da mittenti autenticati. Il valore predefinito è $false.

SecondaryAddress

Facoltativo

System.String

Questo parametro consente di specificare l'indirizzo secondario utilizzato dal contatto abilitato alla messaggistica unificata.

SecondaryDialPlan

Facoltativo

Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter

Questo parametro consente di specificare un dial plan di messaggistica unificata secondario da utilizzare. Viene fornito per creare un indirizzo proxy secondario.

SimpleDisplayName

Facoltativo

System.String

Il parametro SimpleDisplayName viene utilizzato per visualizzare una descrizione alternativa dell'oggetto quando è consentito solo un set di caratteri limitato. Tale set di caratteri limitato è composto dai caratteri ASCII compresi tra il carattere 26 e il carattere 126.

UMDtmfMap

Facoltativo

Microsoft.Exchange.Data.MultiValuedProperty

Questo parametro consente di specificare se si intende creare una mappa DTMF definita dall'utente per il contatto abilitato alla messaggistica unificata. 

UseMapiRichTextFormat

Facoltativo

Microsoft.Exchange.Data.Directory.Recipient.UseMapiRichTextFormat

Il parametro UseMapiRichTextFormat consente di specificare come vengono gestiti i messaggi nel formato MAPI RTF per il contatto di posta. Impostare questo parametro su Mai per convertire in testo normale tutti i messaggi inviati al contatto. Impostare questo parametro su Sempre per inviare sempre messaggi al contatto in formato MAPI RTF. Impostare il parametro su UseDefaultSettings per decidere il formato sulla base dell'impostazione configurata nel client MAPI che ha inviato il messaggio.

UsePreferMessageFormat

Facoltativo

System.Boolean

Il parametro UsePreferMessageFormat consente di specificare se le impostazioni del formato del messaggio configurate per il contatto di posta hanno la priorità sulle impostazioni globali configurate per il dominio remoto. Impostare il parametro su $true per configurare le impostazioni del formato del messaggio per avere le priorità sulle impostazioni globali.

UseRusServer

Facoltativo

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

Il parametro UseRusServer indica al comando di utilizzare il server Cassette postali specificato su cui è in esecuzione il Servizio elenco di indirizzi per ottenere e quindi impostare gli attributi utente delle cassette postali e di Active Directory.

Il Servizio elenco di indirizzi è un componente del servizio Supervisore sistema di Exchange; consente di creare e mantenere valori degli attributi specifici di Exchange in Active Directory. È possibile utilizzare il Servizio per aggiornare oggetti destinatario in un dominio utilizzando informazioni specifiche, ad esempio 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. Il parametro WhatIf consente di visualizzare le modifiche che verrebbero apportate senza applicarle. Con il parametro WhatIf non è necessario specificare un valore.

WindowsEmailAddress

Facoltativo

Microsoft.Exchange.Data.SmtpAddress

Il parametro WindowsEmailAddress consente di specificare l'indirizzo di posta elettronica di Windows per la cassetta postale. Questo indirizzo non viene utilizzato da Exchange.

Tipi di input

Tipi restituiti

Errori

Errore Descrizione

 

Eccezioni

Eccezioni Descrizione

 

Esempio

In questo esempio, il comando Set-MailContact viene utilizzato per impostare l'indirizzo di posta elettronica esterno di John Peoples su john@contoso.com.

Set-MailContact -Identity "John Peoples" -ExternalEmailAddress "john@contoso.com"