New-Mailbox (RTM)

Articolo
08/07/2014

Si applica a: Exchange Server 2007

Ultima modifica dell'argomento: 2008-03-13

Il cmdlet New-Mailbox consente di creare un nuovo utente nel servizio directory di Active Directory e di abilitare tale utente all'utilizzo della cassetta postale.

Sintassi

New-Mailbox -Name <String> -Database <DatabaseIdParameter> -OrganizationalUnit <OrganizationalUnitIdParameter> -Password <SecureString> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>]

New-Mailbox -Name <String> -Database <DatabaseIdParameter> -LinkedDomainController <String> -LinkedMasterAccount <UserIdParameter> -OrganizationalUnit <OrganizationalUnitIdParameter> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-LinkedCredential <PSCredential>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-Password <SecureString>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>]

New-Mailbox -Name <String> -Database <DatabaseIdParameter> -OrganizationalUnit <OrganizationalUnitIdParameter> -Room <SwitchParameter> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-Password <SecureString>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>]

New-Mailbox -Name <String> -Database <DatabaseIdParameter> -Equipment <SwitchParameter> -OrganizationalUnit <OrganizationalUnitIdParameter> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-Password <SecureString>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>]

New-Mailbox -Name <String> -Database <DatabaseIdParameter> -OrganizationalUnit <OrganizationalUnitIdParameter> -Shared <SwitchParameter> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-Password <SecureString>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>]

Descrizione dettagliata

Per eseguire il cmdlet New-Mailbox, è 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.

Parametri

Parametro	Obbligatorio	Tipo	Descrizione
Database	Obbligatorio	Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter	Il parametro Database consente di specificare quale database di Exchange conterrà la cassetta postale del nuovo utente. È possibile utilizzare i seguenti valori: GUID del database Nome database Nome server\nome database Nome server\gruppo di archiviazione\nome database
Apparecchiatura	Obbligatorio	System.Management.Automation.SwitchParameter	Se la cassetta postale è relativa a una risorsa, il parametro Equipment indica che la risorsa è di tipo attrezzatura. È un parametro obbligatorio solo se si crea una cassetta postale per la risorsa.
LinkedDomainController	Obbligatorio	System.String	Il parametro LinkedDomainController consente di specificare il controller di dominio nella foresta dove risiede l'account utente. Il controller di dominio contenuto in questa foresta viene utilizzato per ottenere le informazioni di protezione per l'account specificato dal parametro LinkedMasterAccount. È un parametro obbligatorio solo se si crea una cassetta postale collegata.
LinkedMasterAccount	Obbligatorio	Microsoft.Exchange.Configuration.Tasks.UserIdParameter	Il parametro LinkedMasterAccount consente di specificare l'account principale nella foresta dove risiede l'account utente. L'account principale è l'account a cui collegare la cassetta postale L'account principale concederà l'accesso alla cassetta postale. È un parametro obbligatorio solo se si crea una cassetta postale collegata. È possibile utilizzare uno dei seguenti valori: GUID Nome distinto (DN) Domain\Account Nome dell'entità utente (UPN, User principal name) LegacyExchangeDN SmtpAddress Alias
Name	Obbligatorio	System.String	Il parametro Name consente di specificare il nome dell'utente. È il nome visualizzato in Utenti e computer di Active Directory oltre a essere il nome utente visualizzato in Proprietà destinatario nella scheda Informazioni utente.
OrganizationalUnit	Obbligatorio	Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter	Il parametro OrganizationalUnit consente di specificare il contenitore dove sarà creato l'utente.
Password	Obbligatorio	System.Security.SecureString	Il parametro Password consente di specificare la password iniziale per il nuovo utente. Non è un parametro obbligatorio se si crea una cassetta postale collegata, una cassetta postale per la risorsa o una cassetta postale condivisa in quanto l'account utente per questi tipi di cassette postali verrà disabilitato.
Sala	Obbligatorio	System.Management.Automation.SwitchParameter	Se la cassetta postale è relativa a una risorsa, il parametro Room indica che la risorsa è di tipo sala. È un parametro obbligatorio solo se si crea una cassetta postale per la risorsa.
Condiviso	Obbligatorio	System.Management.Automation.SwitchParameter	Il parametro Shared consente di specificare che si sta creando una cassetta postale condivisa. Una cassetta postale condivisa è una cassetta postale a cui possono accedere più utenti e non è associata a nessuno di questi utenti, bensì a un account utente disabilitato. È un parametro obbligatorio solo se si crea una cassetta postale condivisa.
UserPrincipalName	Obbligatorio	System.String	Il parametro UserPrincipalName consente di specificare il nome dell'entità utente (UPN, User principal name) per la cassetta postale. Si tratta del nome di accesso dell'utente e consiste di un nome utente più un suffisso. In genere, il suffisso è costituito dal nome del dominio in cui risiede l'account utente.
ActiveSyncMailboxPolicy	Facoltativo	Microsoft.Exchange.Configuration.Tasks.MailboxPolicyIdParameter	Il parametro ActiveSyncMailboxPolicy consente di specificare il criterio cassetta postale da abilitare per la cassetta postale che si sta creando. Se questo parametro non viene specificato, viene utilizzato il criterio cassetta postale predefinito.
Alias	Facoltativo	System.String	Il parametro Alias consente di specificare l'alias di posta elettronica dell'utente che si sta creando. L'alias può essere una combinazione di caratteri separati da un punto e senza spazi. I caratteri speciali non devono essere utilizzati nell'alias.
DisplayName	Facoltativo	System.String	Il parametro DisplayName consente di specificare il nome visualizzato per il nuovo utente creato con questa cassetta postale. Il parametro DisplayName è il nome che viene visualizzato in Exchange Management Console sotto Configurazione destinatario. DisplayName è inoltre visualizzato in Utenti e computer di Active Directory nella scheda Proprietà generali dell'utente.
DomainController	Facoltativo	Microsoft.Exchange.Data.Fqdn	Il parametro DomainController consente di specificare il controller di dominio da utilizzare per scrivere le modifiche di configurazione in Active Directory. Utilizzare il nome di dominio completo del controller di dominio che si desidera utilizzare.
FirstName	Facoltativo	System.String	Il parametro FirstName consente di specificare il nome dell'utente che si sta creando.
Initials	Facoltativo	System.String	Il parametro Initials consente di specificare le iniziali dell'utente che si sta creando.
LastName	Facoltativo	System.String	Il parametro LastName consente di specificare il cognome dell'utente che si sta creando.
LinkedCredential	Facoltativo	System.Management.Automation.PSCredential	Il parametro LinkedCredential consente di specificare le credenziali da utilizzare per accedere al controller di dominio specificato dal parametro LinkedDomainController. È un parametro facoltativo anche se si abilita una cassetta postale collegata.
ManagedFolderMailboxPolicy	Facoltativo	Microsoft.Exchange.Configuration.Tasks.MailboxPolicyIdParameter	Il parametro ManagedFolderMailboxPolicy consente di specificare il criterio cassetta postale della cartella gestita da abilitare per la cassetta postale che si sta creando.
ManagedFolderMailboxPolicyAllowed	Facoltativo	System.Management.Automation.SwitchParameter	Il parametro ManagedFolderMailboxPolicyAllowed consente di ignorare l'avviso nel quale è indicato che le funzionalità di gestione dei record di messaggistica non sono supportate per i client di posta elettronica che utilizzano versioni di Microsoft Outlook precedenti a Outlook 2007. Quando un criterio cassetta postale della cartella gestita viene assegnato a una cassetta postale che utilizza il parametro ManagedFolderMailboxPolicy, l'avviso viene visualizzato per impostazione predefinita, a meno che non si utilizzi ManagedFolderMailboxPolicyAllowed. Nota I client Outlook 2003 Service Pack 3 sono supportati ma sono provvisti di funzionalità limitate per la gestione dei record di messaggistica.
ResetPasswordOnNextLogon	Facoltativo	System.Boolean	Se impostato su $true, il parametro ResetPasswordOnNextLogon indica che la password nel parametro Password dovrà essere reimpostata quando l'utente effettuerà un nuovo accesso.
SamAccountName	Facoltativo	System.String	Il parametro SamAccountName consente di specificare il nome di accesso utilizzato per supportare i client e i server in cui sono in esecuzione versioni precedenti del sistema operativo, come Microsoft Windows NT 4.0, Windows 95, Windows 98 e LAN Manager. Per poter supportare client con versioni precedenti, l'attributo non deve superare i 20 caratteri. Se non si specifica questo parametro, verrà automaticamente creato da Active Directory un SAMAccountName, in base al nome dell'entità utente.
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.

Tipi di input

Tipi restituiti

Errori

Errore	Descrizione

Eccezioni

Eccezioni	Descrizione

Esempio

Nel primo esempio viene descritto come creare un utente Chris Ashton in Active Directory e una cassetta postale per l'utente stesso. La cassetta postale è situata nel Gruppo di archiviazione 1, nel Database per le cassette postali 1. La password va reimpostata all'accesso successivo. In questo esempio viene descritto come impostare il valore iniziale della password: viene creata una variabile, $password, viene richiesta l'immissione della password, che poi viene assegnata alla variabile come un oggetto SecureString.

Nel secondo esempio viene descritto come creare un utente in Active Directory e una cassetta postale delle risorse per una sala conferenze. La cassetta postale per la risorsa è situata nel Gruppo di archiviazione 1, nel Database per le cassette postali 1. La password va reimpostata all'accesso successivo. In Exchange Management Shell verrà richiesto il valore della password iniziale, in quanto non specificato.

$password = Read-Host "Enter password" -AsSecureString
New-mailbox -UserPrincipalName chris@contoso.com -alias chris -database "Storage Group 1\Mailbox Database 1" -Name ChrisAshton -OrganizationalUnit Users -password $password -FirstName Chris -LastName Ashton -DisplayName "Chris Ashton" -ResetPasswordOnNextLogon $true

New-Mailbox -UserPrincipalName confmbx@contoso.com -alias confmbx -name ConfRoomMailbox -database "Storage Group 1\Mailbox Database 1" -OrganizationalUnit Users -Room -ResetPasswordOnNextLogon $true