Set-AddressList (RTM)

Articolo
08/07/2014

Si applica a: Exchange Server 2007

Ultima modifica dell'argomento: 2007-10-23

Il cmdlet Set-AddressList consente di modificare un elenco di indirizzi esistente.

Sintassi

Set-AddressList -Identity <AddressListIdParameter> [-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>] [-DisplayName <String>] [-DomainController <Fqdn>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Name <String>] [-RecipientFilter <String>]

Set-AddressList [-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>] [-DisplayName <String>] [-DomainController <Fqdn>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Instance <AddressList>] [-Name <String>] [-RecipientFilter <String>]

Descrizione dettagliata

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

Se non si desidera utilizzare Exchange Management Console per gestire gli elenchi indirizzi creati in Exchange Server 2003 o Exchange 2000 Server, è necessario procedere come segue:

Aggiornare l'attributo della versione dell'elenco indirizzi utilizzando il parametro ForceUpgrade.
Modificare il filtro destinatario utilizzando il parametro RecipientFilter o uno dei seguenti parametri del filtro:
- ConditionalCompany
- ConditionalDepartment
- ConditionalStateOrProvince
- IncludedRecipients

Parametri

Parametro	Obbligatorio	Tipo	Descrizione
Identity	Obbligatorio	Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter	Il parametro Identity consente di specificare il GUID, il nome distinto o il nome dell'elenco indirizzi che rappresenta uno specifico elenco indirizzi. È inoltre possibile includere il percorso utilizzando il formato Percorso\NomeElenco indirizzi. È possibile omettere l'etichetta del parametro Identity affinché venga fornito solo il nome dell'elenco indirizzi o il GUID.
ConditionalCompany	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro ConditionalCompany è un filtro che consente di specificare un'azienda. Tutti i destinatari con un attributo azienda che corrisponde al valore immesso per questo parametro verranno inclusi nell'elenco indirizzi da modificare. È possibile utilizzare più valori come un elenco delimitato da virgole. È necessario utilizzare il parametro IncludedRecipients se si utilizza il 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. Gli attributi personalizzati consentono di aggiungere ulteriori informazioni all'elenco indirizzi, tramite le quali è possibile ordinare o raggruppare elenchi indirizzi. È necessario utilizzare il parametro IncludedRecipients se si utilizza il 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. Gli attributi personalizzati consentono di aggiungere ulteriori informazioni all'elenco indirizzi, tramite le quali è possibile ordinare o raggruppare elenchi indirizzi. È necessario utilizzare il parametro IncludedRecipients se si utilizza il 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. Gli attributi personalizzati consentono di aggiungere ulteriori informazioni all'elenco indirizzi, tramite le quali è possibile ordinare o raggruppare elenchi indirizzi. È necessario utilizzare il parametro IncludedRecipients se si utilizza il 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. Gli attributi personalizzati consentono di aggiungere ulteriori informazioni all'elenco indirizzi, tramite le quali è possibile ordinare o raggruppare elenchi indirizzi. È necessario utilizzare il parametro IncludedRecipients se si utilizza il 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. Gli attributi personalizzati consentono di aggiungere ulteriori informazioni all'elenco indirizzi, tramite le quali è possibile ordinare o raggruppare elenchi indirizzi. È necessario utilizzare il parametro IncludedRecipients se si utilizza il 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. Gli attributi personalizzati consentono di aggiungere ulteriori informazioni all'elenco indirizzi, tramite le quali è possibile ordinare o raggruppare elenchi indirizzi. È necessario utilizzare il parametro IncludedRecipients se si utilizza il 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. Gli attributi personalizzati consentono di aggiungere ulteriori informazioni all'elenco indirizzi, tramite le quali è possibile ordinare o raggruppare elenchi indirizzi. È necessario utilizzare il parametro IncludedRecipients se si utilizza il 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. Gli attributi personalizzati consentono di aggiungere ulteriori informazioni all'elenco indirizzi, tramite le quali è possibile ordinare o raggruppare elenchi indirizzi. È necessario utilizzare il parametro IncludedRecipients se si utilizza il 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. Gli attributi personalizzati consentono di aggiungere ulteriori informazioni all'elenco indirizzi, tramite le quali è possibile ordinare o raggruppare elenchi indirizzi. È necessario utilizzare il parametro IncludedRecipients se si utilizza il 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. Gli attributi personalizzati consentono di aggiungere ulteriori informazioni all'elenco indirizzi, tramite le quali è possibile ordinare o raggruppare elenchi indirizzi. È necessario utilizzare il parametro IncludedRecipients se si utilizza il 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. Gli attributi personalizzati consentono di aggiungere ulteriori informazioni all'elenco indirizzi, tramite le quali è possibile ordinare o raggruppare elenchi indirizzi. È necessario utilizzare il parametro IncludedRecipients se si utilizza il 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. Gli attributi personalizzati consentono di aggiungere ulteriori informazioni all'elenco indirizzi, tramite le quali è possibile ordinare o raggruppare elenchi indirizzi. È necessario utilizzare il parametro IncludedRecipients se si utilizza il 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. Gli attributi personalizzati consentono di aggiungere ulteriori informazioni all'elenco indirizzi, tramite le quali è possibile ordinare o raggruppare elenchi indirizzi. È necessario utilizzare il parametro IncludedRecipients se si utilizza il 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. Gli attributi personalizzati consentono di aggiungere ulteriori informazioni all'elenco indirizzi, tramite le quali è possibile ordinare o raggruppare elenchi indirizzi. È necessario utilizzare il parametro IncludedRecipients se si utilizza il 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. Gli attributi personalizzati consentono di aggiungere ulteriori informazioni all'elenco indirizzi, tramite le quali è possibile ordinare o raggruppare elenchi indirizzi. È necessario utilizzare il parametro IncludedRecipients se si utilizza il parametro Conditional. Non è possibile utilizzare questo parametro se si utilizza il parametro RecipientFilter.
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. È necessario utilizzare il parametro IncludedRecipients se si utilizza il parametro Conditional. Non è possibile utilizzare questo parametro se si utilizza il parametro RecipientFilter.
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. È necessario utilizzare il parametro IncludedRecipients se si utilizza il parametro Conditional. Non è possibile utilizzare questo parametro se si utilizza il parametro RecipientFilter.
DisplayName	Facoltativo	System.String	Il parametro DisplayName consente di specificare il nome visualizzato desiderato per l'elenco indirizzi.
DomainController	Facoltativo	Microsoft.Exchange.Data.Fqdn	Per specificare il nome di dominio completo (FQDN, fully qualified domain name) del controller di dominio che consente di scrivere la modifica alla configurazione nel servizio directory di Active Directory, includere nel comando il parametro DomainController.
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 dopo l'aggiornamento di un elenco indirizzi creato in Microsoft Exchange Server 2003 o Exchange 2000 Server. Non è possibile gestire un elenco di indirizzi di Exchange 2003 o di Exchange 2000 utilizzando Exchange Management Console finché non viene aggiornata la versione dell'oggetto e modificato il filtro destinatario utilizzando il parametro RecipientFilter o IncludedRecipients.
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 utilizza uno qualsiasi dei parametri Conditional. Non è possibile utilizzare questo parametro se si utilizza il parametro RecipientFilter.
Instance	Facoltativo	Microsoft.Exchange.Data.Directory.Management.AddressList	Il parametro Instance viene raramente utilizzato dagli amministratori che utilizzano la riga di comando. È incluso nella tabella dei parametri come riferimento per gli sviluppatori.
Nome	Facoltativo	System.String	Il parametro Name specifica un nuovo nome per l'elenco indirizzi. Il nome non può superare i 64 caratteri e non può includere un ritorno a capo o una barra rovesciata (\).
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 RecipientContainer 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

Nel primo esempio viene mostrato come modificare il nome di un elenco indirizzi esistente.

Nel secondo esempio viene mostrato come modificare il tipo e il reparto dei destinatari che verranno inclusi nell'elenco indirizzi denominato MyAddressList2. MyAddressList2 è un elenco indirizzi di Exchange 2003, pertanto questo comando aggiornerà anche questo elenco indirizzi.

Set-AddressList -Identity "All Users\Sales\building4" -Name building9
Set-Addresslist -Identity c3fffd8e-026b-41b9-88c4-8c21697ac8ac -IncludedRecipients UserMailbox -ConditionalDepartment Sales -ForceUpgrade:$true

Utilizzare il comando Get-AddressList, dopo averne eseguito il piping aFormat-List, per ottenere il GUID, il nome distinto o il percorso e il nome di un elenco indirizzi esistente. In alternativa utilizzare Get-AddressList per ottenere uno elenco indirizzi esistente specifico e quindi eseguire il piping dell'output direttamente in Set-AddressList.

Condividi tramite