Set-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 Set-AddressList consente di modificare un elenco di indirizzi esistente.
Sintassi
Set-AddressList -Identity <AddressListIdParameter> [-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>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Name <String>] [-RecipientFilter <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]
Set-AddressList [-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>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Instance <AddressList>] [-Name <String>] [-RecipientFilter <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]
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 di amministrazione 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 |
Microsoft.Exchange.Data.MultiValuedProperty |
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 |
Microsoft.Exchange.Data.MultiValuedProperty |
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 |
Microsoft.Exchange.Data.MultiValuedProperty |
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 |
Microsoft.Exchange.Data.MultiValuedProperty |
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 |
Microsoft.Exchange.Data.MultiValuedProperty |
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 |
Microsoft.Exchange.Data.MultiValuedProperty |
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 |
Microsoft.Exchange.Data.MultiValuedProperty |
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 |
Microsoft.Exchange.Data.MultiValuedProperty |
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 |
Microsoft.Exchange.Data.MultiValuedProperty |
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 |
Microsoft.Exchange.Data.MultiValuedProperty |
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 |
Microsoft.Exchange.Data.MultiValuedProperty |
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 |
Microsoft.Exchange.Data.MultiValuedProperty |
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 |
Microsoft.Exchange.Data.MultiValuedProperty |
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 |
Microsoft.Exchange.Data.MultiValuedProperty |
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 |
Microsoft.Exchange.Data.MultiValuedProperty |
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 con 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 con il parametro RecipientFilter. |
||
Confirm |
Facoltativo |
System.Management.Automation.SwitchParameter |
Il parametro Confirm consente di determinare la sospensione dell'elaborazione e di richiedere che l'utente confermi l'operazione che verrà eseguita dal comando prima che l'elaborazione continui. Con il parametro Confirm non è necessario specificare un valore. |
||
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) 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 elimina la seguente conferma: "Per salvare le modifiche all'oggetto "{0}", è 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 indirizzi di Exchange 2003 o Exchange 2000 utilizzando Exchange Management Console finché non viene aggiornata la versione e modificato il filtro destinatari con 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 con 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. Viene incluso nella tabella dei parametri come riferimento per gli sviluppatori. |
||
Name |
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:
Per ulteriori informazioni sulle proprietà che è possibile filtrare, vedere Proprietà che è possibile filtrare per il parametro -RecipientFilter. |
||
UseRusServer |
Facoltativo |
System.String |
Il parametro UseRusServer consente al comando di utilizzare il server Cassette postali specificato su cui è in esecuzione il Servizio elenco di indirizzi per ottenere e impostare la cassetta postale e gli attributi dell'utente Active Directory. Il Servizio elenco indirizzi è un componente del servizio Supervisore sistema di Exchange. Il Servizio elenco indirizzi consente di creare e gestire i valori degli attributi specifici di Exchange in Active Directory. È possibile utilizzare il Servizio elenco indirizzi per aggiornare gli oggetti destinatario in un dominio utilizzando informazioni specifiche, come l'appartenenza a un elenco di indirizzi e gli indirizzi di posta elettronica. |
||
WhatIf |
Facoltativo |
System.Management.Automation.SwitchParameter |
Il parametro WhatIf consente di indicare al comando di simulare le azioni da eseguire sull'oggetto. Il parametro WhatIf consente di visualizzare le modifiche che verrebbero apportate senza applicarle. Con il parametro WhatIf non è necessario specificare un valore. |
.gif "note")
Nota: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.