Set-MailContact
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:
|
||
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:
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:
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:
|
||
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:
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:
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. |
||
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 |
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. |
.gif "note")
Nota: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"