New-MailUser
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:
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. |
||
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 |
||
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 |
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. |
.gif "note")
Nota: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