Set-GlobalAddressList

 

Si applica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Ultima modifica dell'argomento: 2009-05-12

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 <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>]] [-DomainController <Fqdn>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Name <String>] [-RecipientFilter <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

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

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 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	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	Microsoft.Exchange.Data.MultiValuedProperty	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	Microsoft.Exchange.Data.MultiValuedProperty	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	Microsoft.Exchange.Data.MultiValuedProperty	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	Microsoft.Exchange.Data.MultiValuedProperty	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	Microsoft.Exchange.Data.MultiValuedProperty	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	Microsoft.Exchange.Data.MultiValuedProperty	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	Microsoft.Exchange.Data.MultiValuedProperty	Questo parametro consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. Se si utilizza un parametro Conditional, è necessario utilizzare il parametro IncludedRecipients. Non è possibile utilizzare questo parametro con il parametro RecipientFilter.
ConditionalCustomAttribute3	Facoltativo	Microsoft.Exchange.Data.MultiValuedProperty	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	Microsoft.Exchange.Data.MultiValuedProperty	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	Microsoft.Exchange.Data.MultiValuedProperty	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	Microsoft.Exchange.Data.MultiValuedProperty	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	Microsoft.Exchange.Data.MultiValuedProperty	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	Microsoft.Exchange.Data.MultiValuedProperty	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	Microsoft.Exchange.Data.MultiValuedProperty	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 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 imposta il paese o la provincia per l'elenco di indirizzi globale. 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.
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.
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 passare 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	Il parametro Name specifica il nuovo nome per l'elenco di indirizzi globale.
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à che è possibile filtrare, vedere Proprietà che è possibile filtrare per il parametro -RecipientFilter.
UseRusServer	Facoltativo	System.String	Nota: Questo parametro è disponibile solo in Exchange 2007 SP2. 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 di 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 intraprendere sull'oggetto. Il parametro WhatIf consente di visualizzare le modifiche che verrebbero apportate senza applicarle. Con il parametro WhatIf non è necessario specificare un valore.

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