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:
È 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 |
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. |
.gif "note")
Nota: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