New-MailUser (RTM)
Si applica a: Exchange Server 2007
Ultima modifica dell'argomento: 2007-06-05
Il cmdlet New-MailUser consente di creare un nuovo utente abilitato all'utilizzo della posta.
Sintassi
New-MailUser -Name <String> -ExternalEmailAddress <ProxyAddress> -OrganizationalUnit <OrganizationalUnitIdParameter> -Password <SecureString> -UserPrincipalName <String> [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-MacAttachmentFormat <BinHex | UuEncode | AppleSingle | AppleDouble>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>] [-UsePreferMessageFormat <$true | $false>]
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 applicabili di Active Directory
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 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. |
OrganizationalUnit |
Obbligatorio |
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). |
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 di punteggiatura e simboli:
|
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. |
Iniziali |
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:
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:
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:
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. |
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 di punteggiatura e simboli:
|
TemplateInstance |
Facoltativo |
System.Management.Automation.PSObject |
Se per il parametro TemplateInstance viene specificato un oggetto esistente, il comando utilizzerà 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. |
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 di Tailspin Toys ma, poiché lavora a stretto contatto con i dipendenti dell'azienda Contoso, gli viene fornito un indirizzo di posta elettronica con dominio contoso.com. Ted non possiede una cassetta postale in Exchange Server presso Contoso. I messaggi di posta elettronica inviati all'indirizzo di posta elettronica di Ted presso contoso.com vengono inoltrati al suo indirizzo di posta elettronica 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