New-AddressList

 

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-AddressList consente di creare un nuovo elenco indirizzi e applicarlo ai destinatari.

Sintassi

New-AddressList -Name <String> [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <MultiValuedProperty>] [-ConditionalCustomAttribute10 <MultiValuedProperty>] [-ConditionalCustomAttribute11 <MultiValuedProperty>] [-ConditionalCustomAttribute12 <MultiValuedProperty>] [-ConditionalCustomAttribute13 <MultiValuedProperty>] [-ConditionalCustomAttribute14 <MultiValuedProperty>] [-ConditionalCustomAttribute15 <MultiValuedProperty>] [-ConditionalCustomAttribute2 <MultiValuedProperty>] [-ConditionalCustomAttribute3 <MultiValuedProperty>] [-ConditionalCustomAttribute4 <MultiValuedProperty>] [-ConditionalCustomAttribute5 <MultiValuedProperty>] [-ConditionalCustomAttribute6 <MultiValuedProperty>] [-ConditionalCustomAttribute7 <MultiValuedProperty>] [-ConditionalCustomAttribute8 <MultiValuedProperty>] [-ConditionalCustomAttribute9 <MultiValuedProperty>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-Confirm [<SwitchParameter>]] [-Container <AddressListIdParameter>] [-DisplayName <String>] [-DomainController <Fqdn>] [-IncludedRecipients <Nullable>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

New-AddressList -Name <String> [-Confirm [<SwitchParameter>]] [-Container <AddressListIdParameter>] [-DisplayName <String>] [-DomainController <Fqdn>] [-RecipientFilter <String>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Per eseguire il cmdlet New-AddressList, è necessario utilizzare un account che disponga della seguente delega:

• Ruolo Exchange Organization Administrator

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.

Parametri

Parametro	Obbligatorio	Tipo	Descrizione
Name	Obbligatorio	System.String	Il parametro Name consente di specificare il nome desiderato per il nuovo elenco indirizzi. Il nome non può superare i 64 caratteri e non può includere un ritorno a capo o una barra rovesciata (\).
ConditionalCompany	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro ConditionalCompany è un filtro che consente di specificare un'azienda. Tutti i destinatari con un attributo relativo alla società che corrisponde al valore inserito per questo parametro verranno inclusi nell'elenco indirizzi. È possibile utilizzare più valori come un elenco delimitato da virgole. Non è possibile utilizzare questo parametro con il parametro RecipientFilter. È possibile utilizzare il parametro RecipientFilter o uno dei seguenti parametri di filtro: ConditionalCompany ConditionalDepartment ConditionalStateOrProvince IncludedRecipients
ConditionalCustomAttribute1	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro ConditionalCustomAttribute1 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.
ConditionalCustomAttribute10	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro ConditionalCustomAttribute10 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.
ConditionalCustomAttribute11	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro ConditionalCustomAttribute11 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.
ConditionalCustomAttribute12	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro ConditionalCustomAttribute12 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.
ConditionalCustomAttribute13	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro ConditionalCustomAttribute13 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.
ConditionalCustomAttribute14	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro ConditionalCustomAttribute14 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.
ConditionalCustomAttribute15	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro ConditionalCustomAttribute15 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.
ConditionalCustomAttribute2	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro ConditionalCustomAttribute2 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.
ConditionalCustomAttribute3	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro ConditionalCustomAttribute3 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.
ConditionalCustomAttribute4	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro ConditionalCustomAttribute4 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.
ConditionalCustomAttribute5	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro ConditionalCustomAttribute5 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.
ConditionalCustomAttribute6	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro ConditionalCustomAttribute6 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.
ConditionalCustomAttribute7	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro ConditionalCustomAttribute7 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.
ConditionalCustomAttribute8	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro ConditionalCustomAttribute8 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.
ConditionalCustomAttribute9	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro ConditionalCustomAttribute9 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.
ConditionalDepartment	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro ConditionalDepartment è un filtro che consente di specificare un dipartimento. Tutti i destinatari con un attributo relativo al reparto che corrisponde al valore inserito per questo parametro verranno inclusi nell'elenco indirizzi. È possibile utilizzare più valori come un elenco delimitato da virgole. Non è possibile utilizzare questo parametro con il parametro RecipientFilter. È possibile utilizzare il parametro RecipientFilter o uno dei seguenti parametri di filtro: ConditionalCompany ConditionalDepartment ConditionalStateOrProvince IncludedRecipients
ConditionalStateOrProvince	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro ConditionalStateOrProvince è un filtro che consente di specificare uno Stato o una provincia. Tutti i destinatari con un attributo ConditionalStateOrProvince che corrisponde al valore immesso per questo parametro verranno inclusi nell'elenco indirizzi. È possibile utilizzare più valori come un elenco delimitato da virgole. Non è possibile utilizzare questo parametro con il parametro RecipientFilter. È possibile utilizzare il parametro RecipientFilter o uno dei seguenti parametri di filtro: ConditionalCompany ConditionalDepartment ConditionalStateOrProvince IncludedRecipients
Confirm	Facoltativo	System.Management.Automation.SwitchParameter	Il parametro Confirm determina l'interruzione dell'elaborazione e richiede che l'amministratore sappia quale operazione eseguirà il comando prima che l'elaborazione continui. Non è necessario specificare un valore con il parametro Confirm.
Container	Facoltativo	Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter	Il parametro Container consente di specificare l'identità dell'elenco indirizzi principale in cui verrà creato il nuovo elenco indirizzi. Se l'elenco indirizzi principale non viene specificato, l'elenco indirizzi verrà creato nella directory radice "Tutti gli elenchi indirizzi".
DisplayName	Facoltativo	System.String	Il parametro DisplayName consente di specificare il nome visualizzato desiderato per l'elenco indirizzi. Se il nome visualizzato non viene specificato, il nome dell'elenco indirizzi corrisponderà al nome visualizzato.
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.
IncludedRecipients	Facoltativo	System.Nullable	Il parametro IncludedRecipients è un filtro che consente di specificare il tipo di destinatario da includere nell'elenco indirizzi. È possibile utilizzare uno o più dei seguenti tipi: None (Nessuno) UserMail Resources (Risorse) MailGroups (Gruppi di posta) MailContacts (Contatti di posta) AllRecipients Non è possibile utilizzare questo parametro con il parametro RecipientFilter. È possibile utilizzare il parametro RecipientFilter o uno dei seguenti parametri di filtro: ConditionalCompany ConditionalDepartment ConditionalStateOrProvince IncludedRecipients
RecipientFilter	Facoltativo	System.String	Il parametro RecipientFilter consente di specificare un filtro per i destinatari da includere nell'elenco indirizzi. Non è possibile utilizzare questo parametro se già si utilizza uno dei seguenti parametri di filtro: ConditionalCompany ConditionalDepartment ConditionalStateOrProvince IncludedRecipients È necessario utilizzare questo parametro o uno dei parametri di filtro descritti in precedenza. Per ulteriori informazioni sulle proprietà filtrabili, vedere Proprietà filtrabili per il parametro -RecipientFilter.
TemplateInstance	Facoltativo	System.Management.Automation.PSObject	Quando 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 Server 2007 SP2. Il parametro UseRusServer indica al comando di utilizzare il server Cassette postali specificato su cui è in esecuzione il Servizio elenco di indirizzi per ottenere e quindi impostare gli attributi utente delle cassette postali e di Active Directory. Il Servizio elenco di indirizzi è un componente del servizio Supervisore sistema di Exchange; consente di creare e mantenere valori degli attributi specifici di Exchange in Active Directory. È possibile utilizzare il Servizio per aggiornare oggetti destinatario in un dominio utilizzando informazioni specifiche, ad esempio l'appartenenza a un elenco di indirizzi e gli indirizzi di posta elettronica.
WhatIf	Facoltativo	System.Management.Automation.SwitchParameter	Il parametro WhatIf consente al comando di simulare le azioni da intraprendere sull'oggetto. Utilizzando il parametro WhatIf, è possibile visualizzare quali sono le modifiche che verrebbero apportate senza applicarle. Non è necessario specificare un valore con il parametro WhatIf.

Tipi di input

Tipi restituiti

Errori

Errore	Descrizione

Eccezioni

Eccezioni	Descrizione

Esempio

Nel primo esempio viene descritto come creare un nuovo elenco di indirizzi denominato MyAddressList. L'elenco di indirizzi include i destinatari utenti di cassetta postale con il parametro StateOrProvince impostato su Washington o Oregon.

Nel secondo esempio viene descritto come creare un nuovo elenco indirizzi denominato MyAddressList2 che comprende le cassette postali con il parametro ConditionalStateOrProvince impostato su Washington.

New-AddressList -Name MyAddressList -RecipientFilter {((RecipientType -eq 'UserMailbox') -and ((StateOrProvince -eq 'Washington') -or (StateOrProvince -eq 'Oregon')))}
New-AddressList -Name MyAddressList2 -ConditionalStateOrProvince Washington -IncludedRecipients MailboxUsers