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