Condividi tramite

Set-MailUser

  • Articolo

 

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

Ultima modifica dell'argomento: 2010-10-21

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>] [-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>] [-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>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

set-MailUser [-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 <MailUser>] [-MacAttachmentFormat <BinHex | 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>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-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 Microsoft 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 (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 se è specificato il parametro Instance.

AcceptMessagesOnlyFrom

Facoltativo

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

Il parametro AcceptMessagesOnlyFrom consente di specificare gli utenti delle cassette postali, gli utenti di posta e i contatti di posta che possono inviare messaggi di posta elettronica a questo utente di posta. È inoltre possibile specificare Microsoft Exchange come destinatario valido per questo parametro. Se si configura un utente di posta affinché possa accettare messaggi solo dal destinatario Microsoft Exchange, 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. Il valore predefinito consente all'utente di posta di accettare 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 utente 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 primario

Per impostazione predefinita, questo parametro è vuoto. Il valore predefinito consente all'utente di posta di accettare i messaggi da tutti i mittenti.

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:

  • !

  • #

  • $

  • %

  • ^

  • &

  • *

  • +

  • -

  • .

  • /

  • =

  • ?

  • _

  • {

  • }

  • |

  • ~

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 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 l'alias di posta elettronica dell'utente 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. 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.RecipientIdParameter

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.

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

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 all'utente 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 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.

Name

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 viene utilizzato per visualizzare una descrizione alternativa dell'oggetto quando è consentito solo un set di caratteri limitato. Tale set di caratteri limitato è composto dai seguenti caratteri.

abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789\"()+,-./:?

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.

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