Condividi tramite


Set-EmailAddressPolicy (RTM)

 

Si applica a: Exchange Server 2007

Ultima modifica dell'argomento: 2008-05-07

Utilizzare il cmdlet Set-EmailAddressPolicy per impostare gli attributi del servizio directory di Active Directory per un criterio indirizzo di posta elettronica.

Sintassi

Set-EmailAddressPolicy -Identity <EmailAddressPolicyIdParameter> [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <String>] [-ConditionalCustomAttribute10 <String>] [-ConditionalCustomAttribute11 <String>] [-ConditionalCustomAttribute12 <String>] [-ConditionalCustomAttribute13 <String>] [-ConditionalCustomAttribute14 <String>] [-ConditionalCustomAttribute15 <String>] [-ConditionalCustomAttribute2 <String>] [-ConditionalCustomAttribute3 <String>] [-ConditionalCustomAttribute4 <String>] [-ConditionalCustomAttribute5 <String>] [-ConditionalCustomAttribute6 <String>] [-ConditionalCustomAttribute7 <String>] [-ConditionalCustomAttribute8 <String>] [-ConditionalCustomAttribute9 <String>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-DomainController <Fqdn>] [-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-EnabledPrimarySMTPAddressTemplate <String>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Name <String>] [-Priority <EmailAddressPolicyPriority>] [-RecipientFilter <String>]

Set-EmailAddressPolicy [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <String>] [-ConditionalCustomAttribute10 <String>] [-ConditionalCustomAttribute11 <String>] [-ConditionalCustomAttribute12 <String>] [-ConditionalCustomAttribute13 <String>] [-ConditionalCustomAttribute14 <String>] [-ConditionalCustomAttribute15 <String>] [-ConditionalCustomAttribute2 <String>] [-ConditionalCustomAttribute3 <String>] [-ConditionalCustomAttribute4 <String>] [-ConditionalCustomAttribute5 <String>] [-ConditionalCustomAttribute6 <String>] [-ConditionalCustomAttribute7 <String>] [-ConditionalCustomAttribute8 <String>] [-ConditionalCustomAttribute9 <String>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-DomainController <Fqdn>] [-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-EnabledPrimarySMTPAddressTemplate <String>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Instance <EmailAddressPolicy>] [-Name <String>] [-Priority <EmailAddressPolicyPriority>] [-RecipientFilter <String>]

Descrizione dettagliata

Il cmdlet Set-EmailAddressPolicy consente agli amministratori di impostare gli attributi di Active Directory per un criterio dell'indirizzo di posta elettronica specifico. Il cmdlet Set-EmailAddressPolicy, tuttavia, non si applica alle modifiche apportate al criterio dell'indirizzo di posta elettronica. Utilizzare il cmdlet Update-EmailAddressPolicy e quindi il cmdlet Set-EmailAddressPolicy per applicare le modifiche.

Per eseguire il cmdlet Set-EmailAddressPolicy, è 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 necessari per l'amministrazione di Microsoft Exchange Server 2007, vedere Considerazioni sulle autorizzazioni.

Per ulteriori informazioni sul cmdlet Update-EmailAddressPolicy vedere Update-EmailAddressPolicy (RTM).

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Microsoft.Exchange.Configuration.Tasks.EmailAddressPolicyIdParameter

Utilizzare il parametro Identity per specificare il GUID, il nome distinto o il nome del criterio di indirizzi di posta elettronica che rappresenta un determinato criterio di indirizzi di posta elettronica. È possibile includere il percorso anche utilizzando il formato Path\EmailAddressPolicy.

È possibile omettere l'etichetta del parametro Identity affinché venga fornito solo il nome del criterio di indirizzi di posta elettronica o il GUID.

ConditionalCompany

Facoltativo

Microsoft.Exchange.Data.MultiValuedProperty

Il parametro ConditionalCompany consente di impostare la società per il criterio dell'indirizzo di posta elettronica. Richiede più valori sotto forma di elenco delimitato da virgole. È necessario utilizzare il parametro IncludedRecipients se si utilizza un parametro Conditional. Non è possibile utilizzare questo parametro se si utilizza il parametro RecipientFilter.

ConditionalCustomAttribute1

Facoltativo

System.String

Il parametro ConditionalCustomAttribute1 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. È necessario utilizzare il parametro IncludedRecipients se si utilizza un parametro Conditional. Non è possibile utilizzare questo parametro se si utilizza il parametro RecipientFilter.

ConditionalCustomAttribute10

Facoltativo

System.String

Il parametro ConditionalCustomAttribute10 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. È necessario utilizzare il parametro IncludedRecipients se si utilizza un parametro Conditional. Non è possibile utilizzare questo parametro se si utilizza il parametro RecipientFilter.

ConditionalCustomAttribute11

Facoltativo

System.String

Il parametro ConditionalCustomAttribute11 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. È necessario utilizzare il parametro IncludedRecipients se si utilizza un parametro Conditional. Non è possibile utilizzare questo parametro se si utilizza il parametro RecipientFilter.

ConditionalCustomAttribute12

Facoltativo

System.String

Il parametro ConditionalCustomAttribute12 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. È necessario utilizzare il parametro IncludedRecipients se si utilizza un parametro Conditional. Non è possibile utilizzare questo parametro se si utilizza il parametro RecipientFilter.

ConditionalCustomAttribute13

Facoltativo

System.String

Il parametro ConditionalCustomAttribute13 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. È necessario utilizzare il parametro IncludedRecipients se si utilizza un parametro Conditional. Non è possibile utilizzare questo parametro se si utilizza il parametro RecipientFilter.

ConditionalCustomAttribute14

Facoltativo

System.String

Il parametro ConditionalCustomAttribute14 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. È necessario utilizzare il parametro IncludedRecipients se si utilizza un parametro Conditional. Non è possibile utilizzare questo parametro se si utilizza il parametro RecipientFilter.

ConditionalCustomAttribute15

Facoltativo

System.String

Il parametro ConditionalCustomAttribute15 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. È necessario utilizzare il parametro IncludedRecipients se si utilizza un parametro Conditional. Non è possibile utilizzare questo parametro se si utilizza il parametro RecipientFilter.

ConditionalCustomAttribute2

Facoltativo

System.String

Il parametro ConditionalCustomAttribute2 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. È necessario utilizzare il parametro IncludedRecipients se si utilizza un parametro Conditional. Non è possibile utilizzare questo parametro se si utilizza il parametro RecipientFilter.

ConditionalCustomAttribute3

Facoltativo

System.String

Il parametro ConditionalCustomAttribute3 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. È necessario utilizzare il parametro IncludedRecipients se si utilizza un parametro Conditional. Non è possibile utilizzare questo parametro se si utilizza il parametro RecipientFilter.

ConditionalCustomAttribute4

Facoltativo

System.String

Il parametro ConditionalCustomAttribute4 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. È necessario utilizzare il parametro IncludedRecipients se si utilizza un parametro Conditional. Non è possibile utilizzare questo parametro se si utilizza il parametro RecipientFilter.

ConditionalCustomAttribute5

Facoltativo

System.String

Il parametro ConditionalCustomAttribute5 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. È necessario utilizzare il parametro IncludedRecipients se si utilizza un parametro Conditional. Non è possibile utilizzare questo parametro se si utilizza il parametro RecipientFilter.

ConditionalCustomAttribute6

Facoltativo

System.String

Il parametro ConditionalCustomAttribute6 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. È necessario utilizzare il parametro IncludedRecipients se si utilizza un parametro Conditional. Non è possibile utilizzare questo parametro se si utilizza il parametro RecipientFilter.

ConditionalCustomAttribute7

Facoltativo

System.String

Il parametro ConditionalCustomAttribute7 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. È necessario utilizzare il parametro IncludedRecipients se si utilizza un parametro Conditional. Non è possibile utilizzare questo parametro se si utilizza il parametro RecipientFilter.

ConditionalCustomAttribute8

Facoltativo

System.String

Il parametro ConditionalCustomAttribute8 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. È necessario utilizzare il parametro IncludedRecipients se si utilizza un parametro Conditional. Non è possibile utilizzare questo parametro se si utilizza il parametro RecipientFilter.

ConditionalCustomAttribute9

Facoltativo

System.String

Il parametro ConditionalCustomAttribute9 consente di specificare gli attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. È necessario utilizzare il parametro IncludedRecipients se si utilizza un parametro Conditional. Non è possibile utilizzare questo parametro se si utilizza il parametro RecipientFilter.

ConditionalDepartment

Facoltativo

Microsoft.Exchange.Data.MultiValuedProperty

Il parametro ConditionalDepartment consente di impostare il reparto per il criterio dell'indirizzo di posta elettronica. Richiede più valori sotto forma di elenco delimitato da virgole. È necessario utilizzare il parametro IncludedRecipients se si utilizza un parametro Conditional. Non è possibile utilizzare questo parametro se si utilizza il parametro RecipientFilter.

ConditionalStateOrProvince

Facoltativo

Microsoft.Exchange.Data.MultiValuedProperty

Il parametro ConditionalStateOrProvince consente di impostare il Paese o la provincia per il criterio dell'indirizzo di posta elettronica. Richiede più valori sotto forma di elenco delimitato da virgole. È necessario utilizzare il parametro IncludedRecipients se si utilizza un parametro Conditional. Non è possibile utilizzare questo parametro se si utilizza il parametro RecipientFilter.

DisabledEmailAddressTemplates

Facoltativo

Microsoft.Exchange.Data.ProxyAddressTemplateCollection

Il parametro DisabledEmailAddressTemplates consente di definire gli indirizzi proxy inclusi in un criterio di indirizzo di posta elettronica e abilitati. Richiede più valori sotto forma di elenco delimitato da virgole.

DomainController

Facoltativo

Microsoft.Exchange.Data.Fqdn

Per specificare il nome di dominio completo (FQDN) del controller di dominio che consente di recuperare i dati da Active Directory, includere nel comando il parametro DomainController.

EnabledEmailAddressTemplates

Facoltativo

Microsoft.Exchange.Data.ProxyAddressTemplateCollection

Il parametro EnabledEmailAddressTemplates definisce gli indirizzi proxy inclusi e abilitati in un criterio dell'indirizzo di posta elettronica. Richiede più valori sotto forma di elenco delimitato da virgole.

EnabledPrimarySMTPAddressTemplate

Facoltativo

System.String

Il parametro EnabledPrimarySMTPAddressTemplate consente di specificare gli indirizzi proxy inclusi e abilitati in un criterio dell'indirizzo di posta elettronica. Richiede più valori sotto forma di elenco delimitato da virgole.

ForceUpgrade

Facoltativo

System.Management.Automation.SwitchParameter

Il parametro ForceUpgrade consente di eliminare la seguente conferma: "Per salvare le modifiche all'oggetto, è necessario che l'oggetto sia aggiornato alla versione corrente di Exchange. Dopo l'aggiornamento non è possibile modificare l'oggetto con una versione precedente di Gestore di sistema di Exchange. Continuare ad aggiornare e salvare l'oggetto?" Questa conferma viene visualizzata quando si aggiorna un criterio di indirizzi di posta elettronica creato in Microsoft Exchange Server 2003 o in Exchange 2000 Server. Non è possibile gestire un criterio di indirizzi di posta elettronica di Exchange 2003 o di Exchange 2000 utilizzando Exchange Management Console senza aver prima aggiornato la versione dell'oggetto e modificato il filtro destinatari con il parametro RecipientFilter o con il parametroIncludedRecipients.

IncludedRecipients

Facoltativo

System.Nullable

Il parametro IncludedRecipients consente di filtrare i tipi di destinatari utilizzati per la creazione dell'elenco indirizzi globale (GAL, Global Address List). I valori disponibili per il parametro IncludedRecipients sono AllRecipients, MailboxUsers, Resources, Contacts e MailGroups.

Il valore AllRecipients può essere utilizzato solo singolarmente. Se più valori del parametro IncludedRecipients vengono separati da virgole, verrà applicato l'operatore booleano OR.

È necessario utilizzare questo parametro se si sta utilizzando uno dei parametri Conditional. Non è possibile utilizzare questo parametro se si utilizza il parametro RecipientFilter.

Instance

Facoltativo

Microsoft.Exchange.Data.Directory.SystemConfiguration.EmailAddressPolicy

Il parametro Instance consente di trasmettere l'intero oggetto al comando da elaborare. Viene utilizzato principalmente negli script in cui è necessario trasmettere l'intero oggetto al comando.

Nome

Facoltativo

System.String

Il parametro Name imposta il nuovo nome per il criterio dell'indirizzo di posta elettronica.

Priorità

Facoltativo

Microsoft.Exchange.Data.Directory.SystemConfiguration.EmailAddressPolicyPriority

Il parametro Priority consente di rendere la priorità corrente più elevata della priorità specificata come argomento per questo parametro.

RecipientFilter

Facoltativo

System.String

Il parametro RecipientFilter filtra i destinatari contenuti in un particolare criterio dell'indirizzo di posta elettronica. Il parametro RecipientFilter non può essere utilizzato se è specificato uno dei seguenti parametri:

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

Per ulteriori informazioni sulle proprietà filtrabili, vedere Proprietà filtrabili per il parametro -RecipientFilter.

Tipi di input

Tipi restituiti

Errori

Errore Descrizione

Eccezioni

Eccezioni Descrizione

Esempio

Il seguente codice è un esempio del comando Set-EmailAddressPolicy in cui il nome del criterio dell'indirizzo di posta elettronica viene cambiato da CRITERIO_INDIRIZZO_POSTA01 a CRITERIOINDIRIZZOPOSTA02.

Set-EmailAddressPolicy -Identity EMAIL_ADDRESS_POLICY01 -Name EMAIL_ADDRESS_POLICY02