Share via


Set-MailUser (RTM)

 

Si applica a: Exchange Server 2007

Ultima modifica dell'argomento: 2007-06-05

Il cmdlet Set-MailUser consente di modificare gli attributi relativi alla posta di un utente esistente nel servizio directory di Active Directory.

Sintassi

set-MailUser -Identity <MailUserIdParameter> [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-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>] [-MacAttachmentFormat <BinHex | UuEncode | AppleSingle | AppleDouble>] [-MaxReceiveSize <Unlimited>] [-MaxSendSize <Unlimited>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RecipientLimits <Unlimited>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SamAccountName <String>] [-SecondaryAddress <String>] [-SecondaryDialPlan <UMDialPlanIdParameter>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-UseMapiRichTextFormat <Never | Always | UseDefaultSettings>] [-UsePreferMessageFormat <$true | $false>] [-UserPrincipalName <String>] [-WindowsEmailAddress <SmtpAddress>]

set-MailUser [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-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>] [-Instance <MailUser>] [-MacAttachmentFormat <BinHex | UuEncode | AppleSingle | AppleDouble>] [-MaxReceiveSize <Unlimited>] [-MaxSendSize <Unlimited>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RecipientLimits <Unlimited>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SamAccountName <String>] [-SecondaryAddress <String>] [-SecondaryDialPlan <UMDialPlanIdParameter>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-UseMapiRichTextFormat <Never | Always | UseDefaultSettings>] [-UsePreferMessageFormat <$true | $false>] [-UserPrincipalName <String>] [-WindowsEmailAddress <SmtpAddress>]

Descrizione dettagliata

Il cmdlet Set-MailUser consente di modificare gli attributi relativi alla posta di un utente abilitato all'utilizzo della posta in Active Directory.

Per eseguire il cmdlet Set-MailUser, è 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 Exchange Server 2007, vedere Considerazioni sulle autorizzazioni.

Nota

Non tutti gli attributi dell'utente possono essere modificati con il cmdlet Set-MailUser. È possibile impostare ulteriori attributi dell'utente non relativi alla posta con il cmdlet Set-User.

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Microsoft.Exchange.Configuration.Tasks.MailUserIdParameter

Il parametro Identity accetta uno dei seguenti valori:

  • ADObjectID

  • GUID

  • Nome distinto (Distinguished Name, DN)

  • Dominio\SamAccountName

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

  • DN legacy

  • Indirizzo di posta elettronica

  • Alias utente

  • Il parametro Identity non può essere utilizzato nel caso in cui sia specificato il parametro Instance.

AcceptMessagesOnlyFrom

Facoltativo

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

Il parametro AcceptMessagesOnlyFrom consente di specificare i destinatari che possono inviare messaggi di posta elettronica a questo utente di posta. È possibile utilizzare uno dei seguenti valori per i mittenti validi:

  • Nome distinto (Distinguished Name, DN)

  • Nome canonico

  • GUID

  • Nome

  • Nome visualizzato

  • Alias

  • Nome distinto legacy di Exchange

  • Indirizzo di posta elettronica SMTP (Simple Mail Transfer Protocol) primario

Per impostazione predefinita, questo parametro è vuoto. Il valore predefinito consente all'utente della cassetta postale di accettare i messaggi da tutti i destinatari.

AcceptMessagesOnlyFromDLMembers

Facoltativo

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

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

  • Nome distinto (Distinguished Name, DN)

  • Nome canonico

  • GUID

  • Nome

  • Nome visualizzato

  • Nome distinto legacy di Exchange

  • Indirizzo di posta elettronica SMTP principale

Per impostazione predefinita, questo parametro è vuoto.

Alias

Facoltativo

System.String

Il parametro Alias consente di specificare l'alias dell'utente. Un alias può contenere lettere, numeri e i seguenti segni di punteggiatura e simboli:

  • !

  • #

  • $

  • %

  • ^

  • &

  • *

  • +

  • -

  • .

  • /

  • =

  • ?

  • _

  • {

  • }

  • |

  • ~

CreateDTMFMap

Facoltativo

System.Boolean

Questo parametro consente di specificare una mappa DTMF (Dual Tone Multi-Frequency) da creare per l'utente.

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 gli indirizzi di posta elettronica proxy della lista di distribuzione.

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. Quando questo parametro è impostato su $true, non è possibile modificare il parametro PrimarySmtpAddress o il parametro WindowsEmailAddress.

Extensions

Facoltativo

Microsoft.Exchange.Data.MultiValuedProperty

Questo parametro consente di specificare uno o più interni per un utente. 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 un indirizzo di posta elettronica esterno all'organizzazione. I messaggi di posta elettronica inviati all'utente vengono inviati a questo indirizzo esterno.

GrantSendOnBehalfTo

Facoltativo

Microsoft.Exchange.Configuration.Tasks.MailboxOrMailUserIdParameter[]

Il parametro GrantSendOnBehalfTo consente di specificare il nome distinto dei destinatari che possono inviare messaggi per conto di questo utente.

HiddenFromAddressListsEnabled

Facoltativo

System.Boolean

Il parametro HiddenFromAddressListsEnabled consente di specificare se l'utente viene visualizzato nell'elenco di indirizzi. Il valore predefinito è $false.

Instance

Facoltativo

Microsoft.Exchange.Data.Directory.Management.MailUser

Il parametro Instance consente di trasmettere l'intero oggetto al comando da elaborare. Viene utilizzato principalmente negli script in cui è necessario trasmettere 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 all'utente di posta elettronica. I valori validi per questo parametro sono:

  • BinHex

  • UUENCODE

  • 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 o UUENCODE 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 dei messaggi di posta elettronica che l'utente di posta può ricevere, da 1 KB a 2.097.151 KB.

Se questo parametro non viene specificato, non saranno applicate restrizioni alla dimensione.

MaxSendSize

Facoltativo

Microsoft.Exchange.Data.Unlimited

Il parametro MaxSendSize consente di specificare la dimensione massima dei messaggi di posta elettronica che l'utente di posta può inviare, da 1 KB a 2.097.151 KB.

Se questo parametro non viene specificato, non saranno applicate restrizioni alla dimensione.

MessageBodyFormat

Facoltativo

Microsoft.Exchange.Data.Directory.Recipient.MessageBodyFormat

Il parametro MessageBodyFormat consente di specificare il formato del corpo del messaggio per i messaggi inviati all'utente 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 all'utente 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.

Nome

Facoltativo

System.String

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

PrimarySmtpAddress

Facoltativo

Microsoft.Exchange.Data.SmtpAddress

Il parametro PrimarySmtpAddress consente di specificare l'indirizzo SMTP principale.

RecipientLimits

Facoltativo

Microsoft.Exchange.Data.Unlimited

Il parametro RecipientLimits consente di specificare il numero massimo di destinatari per i messaggi da questo utente.

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.

SamAccountName

Facoltativo

System.String

Il parametro SamAccountName consente di definire il nome di accesso utilizzato per supportare i client e i server che eseguono versioni precedenti del sistema operativo, quali ad esempio Microsoft Windows NT 4.0, Windows 98, Windows 95 e LAN Manager. Questo attributo deve includere meno di 20 caratteri. Un nome di account può contenere lettere, numeri e i seguenti segni di punteggiatura e simboli:

  • !

  • #

  • $

  • %

  • ^

  • &

  • -

  • .

  • _

  • {

  • }

  • |

  • ~

SecondaryAddress

Facoltativo

System.String

Questo parametro consente di specificare l'indirizzo secondario utilizzato dall'utente 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 consente di 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 l'utente abilitato alla messaggistica unificata.

UseMapiRichTextFormat

Facoltativo

Microsoft.Exchange.Data.Directory.Recipient.UseMapiRichTextFormat

Il parametro UseMapiRichTextFormat consente di specificare il modo in cui i messaggi in formato RTF (Rich Text Format) MAPI saranno gestiti per questo utente di posta. Impostare questo parametro su Mai per convertire tutti i messaggi inviati a questo utente in testo normale. Impostare questo parametro su Sempre per inviare sempre i messaggi a questo utente in formato RTF MAPI. 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 dei messaggi configurate per l'utente di posta sostitueranno le impostazioni globali configurate per il dominio remoto. Impostare questo parametro su $true per configurare le impostazioni del formato dei messaggi per l'utente di posta per sostituire le impostazioni globali.

UserPrincipalName

Facoltativo

System.String

Il parametro UserPrincipalName consente di specificare il nome dell'entità utente (UPN) per l'utente.

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-MailUser viene utilizzato per impostare l'indirizzo di posta elettronica esterno all'organizzazione a cui viene inviata la posta elettronica dell'utente abilitato all'utilizzo di posta elettronica John People.

Set-MailUser john -ExternalEmailAddress john@tailspintoys.com