Set-GlobalAddressList (RTM)

 

Si applica a: Exchange Server 2007

Ultima modifica dell'argomento: 2007-06-05

Per modificare gli attributi nel servizio directory Active Directory per un elenco indirizzi globale (GAL), utilizzare il cmdlet Set-GlobalAddressList.

Sintassi

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

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

Descrizione dettagliata

Il cmdlet Set-GlobalAddressList modifica le proprietà su un GAL.

Per eseguire il cmdlet Set-GlobalAddressList, è 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 Exchange Server 2007, vedere Considerazioni sulle autorizzazioni.

Parametri

Parametro	Obbligatorio	Tipo	Descrizione
Identity	Obbligatorio	Microsoft.Exchange.Configuration.Tasks.GlobalAddressListIdParameter	Il parametro Identity consente di specificare il GUID, il nome distinto o il nome dell'elenco indirizzi globale (GAL) che rappresenta un GAL specifico. È possibile anche includere il percorso utilizzando il formato Path\GlobalAddressListName. È possibile omettere l'etichetta del parametro Identity affinché venga fornito solo il nome dell'elenco indirizzi globale o il GUID.
ConditionalCompany	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Il parametro ConditionalCompany è utilizzato per specificare una società. È 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	Questo parametro consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. È 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	Questo parametro consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. È 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	Questo parametro consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. È 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	Questo parametro consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. È 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	Questo parametro consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. È 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	Questo parametro consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. È 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	Questo parametro consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. È 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	Questo parametro consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive.
ConditionalCustomAttribute3	Facoltativo	System.String	Questo parametro consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. È 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	Questo parametro consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. È 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	Questo parametro consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. È 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	Questo parametro consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. È 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	Questo parametro consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. È 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	Questo parametro consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. È 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	Questo parametro consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. È 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 è utilizzato per specificare un reparto. Verranno inclusi tutti i GAL con un attributo reparto che corrisponda al valore immesso per questo parametro. È 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.
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.
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 elenco indirizzi globale (GAL) creato in Microsoft Exchange Server 2003 o in Exchange 2000 Server. Non è possibile gestire un elenco indirizzi globale 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 destinatario utilizzati per creare il GAL. 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.Management.GlobalAddressList	Il parametro Instance consente di trasmettere l'intero oggetto al comando per l'elaborazione. Viene utilizzato principalmente negli script in cui è necessario passare l'intero oggetto al comando.
Name	Facoltativo	System.String	Nessuna.
RecipientFilter	Facoltativo	System.String	Il parametro RecipientFilter consente di specificare un filtro per i destinatari da includere nel GAL. Non è possibile utilizzare questo parametro se si utilizza uno dei seguenti parametri di filtro: ConditionalCompany ConditionalDepartment IncludedRecipients ConditionalStateorProvince È necessario utilizzare questo parametro o uno dei parametri di filtro elencati in precedenza. Per ulteriori informazioni sulle proprietà filtrabili, vedere Proprietà filtrabili per il parametro -RecipientFilter.
ConditionalStateOrProvince	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	Nessuna.

Tipi di input

Tipi restituiti

Errori

Errore	Descrizione

Eccezioni

Eccezioni	Descrizione

Esempio

In questo esempio il comando Set-GlobalAddressList è utilizzato per assegnare un nuovo nome, GALwithNewName, al GAL con il GUID 96d0c505-eba8-4103-ad4f-577a1bf4ad7b.

Set-GlobalAddressList 96d0c505-eba8-4103-ad4f-577a1bf4ad7b -Name GALwithNewName