New-Mailbox

 

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-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> -Password <SecureString> -UserPrincipalName <String> [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>] [-ManagedFolderMailboxPolicyAllowed <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

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

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

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

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

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 di Active Directory appropriati 

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

Le cartelle personalizzate gestite sono una funzionalità avanzata di Gestione record di messaggistica. Le cassette postali con criteri che comprendono cartelle personalizzate gestite necessitano di una licenza di accesso client (CAL) di Exchange Server Enterprise.

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
Equipment	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 e che consentirà 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) LegacyExchangeDN Indirizzo SMTP 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à di Destinatario nella scheda Informazioni 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.
Room	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.
Shared	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 questa 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 senza spazi. I caratteri speciali non devono essere utilizzati nell'alias.
Confirm	Facoltativo	System.Management.Automation.SwitchParameter	Il parametro Confirm determina la sospensione dell'elaborazione e richiede che l'utente confermi l'operazione che verrà eseguita dal comando prima che l'elaborazione continui. Non è necessario specificare un valore per il parametro Confirm.
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 in Active Directory la modifica apportata alla configurazione. 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 l'accesso 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, per impostazione predefinita l'avviso viene visualizzato, a meno che non sia stato utilizzato il parametro ManagedFolderMailboxPolicyAllowed. Nota I client Outlook 2003 Service Pack 3 sono supportati ma sono provvisti di funzionalità limitate per la gestione dei record di messaggistica.
OrganizationalUnit	Facoltativo	Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter	Il parametro OrganizationalUnit consente di specificare il contenitore dove sarà creato l'utente.
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.
UseRusServer	Facoltativo	System.String	Nota: 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. Non è necessario specificare un valore per il parametro WhatIf.

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