Modelli

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

Ultima modifica dell'argomento: 2007-08-29

In questo argomento viene descritto come utilizzare i modelli in Exchange Management Shell per copiare la configurazione di un oggetto in un altro oggetto.

Gli esempi contenuti in questo argomento descrivono come utilizzare i modelli quando si crea una nuova cassetta postale attraverso i cmdlet New-Mailbox e Set-Mailbox. Tuttavia, è possibile utilizzare i modelli con numerosi cmdlet. Nonostante le differenze nei requisiti per i vari cmdlet, è possibile utilizzare i modelli nello stesso modo per tutti i cmdlet.

Utilità dei modelli

In Microsoft Exchange Server 2007, è possibile utilizzare Exchange Management Shell per amministrare gli oggetti, quali le cassette postali, i connettori di invio e i criteri degli elenchi di indirizzi di posta elettronica. Tali oggetti possono contenere diverse proprietà da configurare. Esempi di proprietà configurabili da un amministratore includono le proprietà che determinano un attributo personalizzato condizionale in un criterio degli elenchi di indirizzi di posta elettronica, se un dominio remoto consente risposte automatiche su Internet e se il routing DNS è abilitato o meno su un connettore di invio.

Se si desidera creare nuovi oggetti basati sulla configurazione di un oggetto esistente, è possibile utilizzare i modelli. Quando si utilizza un modello per creare un nuovo oggetto, Exchange Management Shell non è in grado di clonare le proprietà richieste, che devono essere univoche. Pertanto, è necessario specificare le proprietà richieste, che devono essere univoche per ogni nuovo oggetto creato.

Diamo un'occhiata a come è possibile utilizzare un modello per risparmiare tempo quando si creano 100 cassette postali con la seguente configurazione personalizzata:

Le proprietà di questa tabella sono esempi delle proprietà che è possibile impostare per le cassette postali utilizzando Exchange Management Shell. Quando si crea una nuova cassetta postale utilizzando il cmdlet New-Mailbox, non è possibile configurare tali proprietà. Per configurare le proprietà, è necessario utilizzare il cmdlet Set-Mailbox. Senza i modelli, sarebbe necessario creare nuove cassette postali configurando di volta in volta le proprietà per ciascuna di esse. Con i modelli, è possibile creare una cassetta postale e configurarne le proprietà utilizzando il cmdlet Set-Mailbox. Quindi, è possibile utilizzare la prima cassetta postale come modello e creare le restanti cassette postali sulla base di tale modello.

Utilizzo di Exchange Management Shell per l'implementazione di modelli

Exchange Management Shell consente di implementare i modelli supportando il parametro TemplateInstance in numerosi cmdlet che includono i verbiNew, Add ed Enable. Il parametro TemplateInstance accetta un oggetto dello stesso tipo dell'oggetto che si tenta di creare. Ad esempio, per creare una nuova cassetta postale utilizzando il cmdlet New-Mailbox, è necessario fornire un oggetto cassetta postale al parametro TemplateInstance. Per ulteriori informazioni sui cmdlet, vedere Concetti relativi ai cmdlet. Per ulteriori informazioni sugli oggetti, vedere Dati strutturati.

Quando si esegue un cmdlet con il parametro TemplateInstance, il cmdlet combina la configurazione recuperata dall'oggetto specificato nel parametro TemplateInstance con i valori specificati nei parametri richiesti del cmdlet. La configurazione combinata viene utilizzata per creare il nuovo oggetto. Non è possibile configurare i valori in un parametro richiesto utilizzando il parametro TemplateInstance.

Per utilizzare un oggetto come modello, è necessario in primo luogo creare l'oggetto e quindi configurarne le proprietà. Dopo aver configurato l'oggetto, è possibile creare oggetti aggiuntivi utilizzando l'oggetto configurato in precedenza come modello. Ad esempio, se si desidera creare una nuova cassetta postale con la configurazione elencata nella tabella della sezione precedente, è necessario in primo luogo creare la cassetta postale con il cmdlet New-Mailbox e quindi utilizzare il cmdlet Set-Mailbox per configurare le proprietà dell'oggetto cassetta postale come nel seguente esempio:

$Password = ConvertTo-SecureString Pass@word1 -AsPlainText -Force
New-Mailbox -Name "Kim Akers" -Database "Mailbox Database" -UserPrincipalName kim@contoso.com -Password $Password
Set-Mailbox "Kim Akers" -RetainDeletedItemsFor 30.00:00:00 -ProhibitSendQuota 1GB -ProhibitSendReceiveQuota 1500MB -IssueWarningQuota 750MB -UseDatabaseQuotaDefaults $False -UseDatabaseRetentionDefaults $False

Per ulteriori informazioni su come gestire le cassette postali, vedere Gestione delle cassette postali utente.

Dopo aver creato e configurato un oggetto cassetta postale che si desidera utilizzare come modello, è possibile creare oggetti cassetta postale aggiuntivi con la stessa configurazione. È necessario in primo luogo assegnare a una variabile l'oggetto cassetta postale che si desidera utilizzare come modello, come nel seguente esempio:

$Template = Get-Mailbox "Kim Akers"

Il nome della variabile non è importante. Per ulteriori informazioni sulle variabili, vedere Variabili definite dall'utente.

Ora che è stato selezionato un oggetto cassetta postale da utilizzare come modello, è possibile creare una nuova cassetta postale utilizzando tale modello, come nel seguente esempio:

$Password = ConvertTo-SecureString Pass@word1 -AsPlainText -Force
New-Mailbox -Name "David Simpson" -Database "Mailbox Database" -UserPrincipalName david@contoso.com -Password $Password -TemplateInstance $Template

Dopo aver creato la nuova cassetta postale, è possibile utilizzare il comando riportato di seguito per visualizzare le proprietà dell'oggetto cassetta postale configurato utilizzando il modello per verificare che siano state impostate correttamente:

Get-Mailbox "David Simpson" | Format-List Name, ProhibitSendQuota, ProhibitSendReceiveQuota, IssueWarningQuota, UseDatabaseQuotaDefaults, UseDatabaseRetentionDefaults, RetainDeletedItemsFor

Name                         : David Simpson
ProhibitSendQuota            : 1GB
ProhibitSendReceiveQuota     : 1500MB
IssueWarningQuota            : 750MB
UseDatabaseQuotaDefaults     : False
UseDatabaseRetentionDefaults : False
RetainDeletedItemsFor        : 30.00:00:00

Per ulteriori informazioni sul cmdlet Format-List, vedere Utilizzo dell'output di comando.

Utilizzo di modelli per la creazione di più oggetti

I modelli si rivelano estremamente utili quando si desidera creare contemporaneamente più oggetti. Ad esempio, è possibile creare cassette postali per ciascun utente elencato in un file con valori delimitati da virgole (CSV) e applicare la stessa configurazione a tutte le nuove cassette postali. Utilizzando i cmdlet Import-CSV e ForEach, è possibile leggere i dati del file CSV e creare una cassetta postale per ogni utente elencato nel file. Ad esempio, si supponga di voler creare nuove cassette postali per gli utenti del seguente file CSV applicando le proprietà configurate per l'oggetto cassetta postale Kim Akers. Il file CSV (Users.csv) contiene le seguenti informazioni:

Name,UPN,MailboxDatabase
Adam Bar,adam@contoso.com,Sales
Mike Ray,mike@contoso.com,Sales
Angela Barbariol,angela@contoso.com,Marketing
Chris Barry,chris@contoso.com,Marketing
Sanjay Jacob,sanjay@contoso.com,Marketing

In primo luogo, assegnare l'oggetto cassetta postale contenente la configurazione che si desidera utilizzare con il modello, come nel seguente esempio:

$Template = Get-Mailbox "Kim Akers"

Quindi, è possibile configurare le cassette postali utilizzando i cmdlet Import-CSV e ForEach:

$Password = ConvertTo-SecureString Pass@word1 -AsPlainText -Force
Import-CSV C:\Users.CSV | ForEach { New-Mailbox -Name $_.Name -UserPrincipalName $_.UPN -Database $_.MailboxDatabase -Password $Password -Template $Template }

Per ulteriori informazioni sul cmdlet ForEach e su come aggiungere più destinatari, vedere i seguenti argomenti:

• Utilizzo di Exchange Management Shell per la gestione globale dei destinatari (informazioni in lingua inglese)

• Pipelining