Condividi tramite


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

noteNota:
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