Condividi tramite

New-MailUser

  • Articolo

 

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

Ultima modifica dell'argomento: 2009-05-12

Il cmdlet New-MailUser consente di creare un nuovo utente abilitato all'utilizzo della posta.

Sintassi

New-MailUser -Name <String> -ExternalEmailAddress <ProxyAddress> -Password <SecureString> -UserPrincipalName <String> [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-MacAttachmentFormat <BinHex | UuEncode | AppleSingle | AppleDouble>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-PrimarySmtpAddress <SmtpAddress>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>] [-UsePreferMessageFormat <$true | $false>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Il cmdlet New-MailUser consente di creare un nuovo oggetto utente abilitato all'utilizzo della posta nel servizio directory di Active Directory.

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

  • Ruolo Exchange Recipient Administrator

  • Ruolo Account Operator per i contenitori di Active Directory applicabili

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

Nota

Non tutti gli attributi dell'utente possono essere impostati con il cmdlet New-MailUser. È possibile eseguire impostazioni aggiuntive con il cmdlet Set-User.

Parametri

Parametro Obbligatorio Tipo Descrizione

ExternalEmailAddress

Obbligatorio

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 abilitato all'utilizzo della posta vengono inviati a questo indirizzo esterno.

Name

Obbligatorio

System.String

Il parametro Name consente di specificare il nome comune dell'utente abilitato alla posta.

Password

Obbligatorio

System.Security.SecureString

Il parametro Password consente di specificare la password utilizzata dall'utente di posta per proteggere il proprio account.

UserPrincipalName

Obbligatorio

System.String

Il parametro UserPrincipalName consente di definire il nome di un utente di sistema in formato indirizzo di posta elettronica (ad esempio, ted@contoso.com).

Alias

Facoltativo

System.String

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

  • !

  • #

  • $

  • %

  • ^

  • &

  • *

  • +

  • -

  • .

  • /

  • =

  • ?

  • _

  • {

  • }

  • |

  • ~

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.

DisplayName

Facoltativo

System.String

Il parametro DisplayName consente di specificare il nome che verrà visualizzato in Microsoft Outlook per l'utente di posta.

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.

FirstName

Facoltativo

System.String

Il parametro FirstName consente di specificare il nome dell'utente di posta.

Initials

Facoltativo

System.String

Il parametro Initials consente di specificare le iniziali dell'utente di posta.

LastName

Facoltativo

System.String

Il parametro LastName consente di specificare il cognome dell'utente 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 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.

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.

OrganizationalUnit

Facoltativo

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Il parametro OrganizationalUnit consente di specificare l'unità organizzativa in cui viene aggiunto il nuovo utente (ad esempio, redmond.contoso.com/contacts).

PrimarySmtpAddress

Facoltativo

Microsoft.Exchange.Data.SmtpAddress

Utilizzare questo parametro per specificare l'indirizzo SMTP primario per l'utente di posta elettronica. Per impostazione predefinita, l'indirizzo SMTP primario viene generato in base ai criteri predefiniti degli indirizzi di posta elettronica. Se si specifica un indirizzo SMTP primario utilizzando questo parametro, il cmdlet imposterà l'attributo EmailAddressPolicyEnabled dell'utente di posta elettronica su $false e gli indirizzi di posta elettronica di questo utente non verranno aggiornati automaticamente in base ai criteri degli indirizzi di posta elettronica.

ResetPasswordOnNextLogon

Facoltativo

System.Boolean

Se il parametro ResetPasswordOnNextLogon è impostato su $true, l'utente deve modificare la password all'accesso successivo.

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 e simboli di punteggiatura:

  • !

  • #

  • $

  • %

  • ^

  • &

  • -

  • .

  • _

  • {

  • }

  • |

  • ~

TemplateInstance

Facoltativo

System.Management.Automation.PSObject

Quando per il parametro TemplateInstance viene fornito 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

Il parametro UsePreferMessageFormat consente di specificare se le impostazioni del messaggio relative al formato configurate per la cassetta postale avranno la priorità sulle impostazioni globali configurate per il dominio. Impostare il parametro su $true per configurare le impostazioni del formato del messaggio per la cassetta postale per avere le priorità sulle impostazioni globali.

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 di indicare al comando di simulare le azioni da eseguire sull'oggetto. Il parametro WhatIf consente di visualizzare le modifiche che verrebbero apportate senza applicarle. Con il parametro WhatIf non è necessario specificare un valore.

Tipi di input

Tipi restituiti

Errori

Errore Descrizione

 

Eccezioni

Eccezioni Descrizione

 

Esempio

Il seguente esempio è costituito da due comandi.

Nel primo comando, viene creata una password del tipo System.Security.SecureString, $password. All'esecuzione del comando, viene visualizzata l'istruzione "Immetti password". La stringa immessa dall'utente diventa la nuova stringa della password, $password.

Nel seguente comando viene creato un nuovo oggetto utente abilitato alla posta denominato Ted Bremer e viene assegnata all'oggetto la password appena creata tramite il parametro Password. Ted è un dipendente della Tailspin Toys, ma, dato che lavora a stretto contatto con i dipendenti dell'azienda Contoso, gli è stato dato un indirizzo di posta elettronica con dominio contoso.com. Ted non dispone di una cassetta postale su Exchange Server presso Contoso. I messaggi di posta elettronica inviati all'indirizzo di posta elettronica contoso.com di Ted vengono inviati al suo indirizzo di posta esterno, ted@tailspintoys.com.

$password = Read-Host "Enter password" -AsSecureString
New-MailUser -Name "Ted Bremer" -Password $password -ExternalEmailAddress ted@tailspintoys.com -UserPrincipalName ted@contoso.com -OrganizationalUnit contoso.com