Set-DistributionGroup (RTM)
Si applica a: Exchange Server 2007
Ultima modifica dell'argomento: 2007-06-05
Il cmdlet Set-DistributionGroup consente di modificare le impostazioni di un gruppo di distribuzione esistente.
Sintassi
Set-DistributionGroup -Identity <DistributionGroupIdParameter> [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-CreateDTMFMap <$true | $false>] [-CustomAttribute1 <String>] [-CustomAttribute10 <String>] [-CustomAttribute11 <String>] [-CustomAttribute12 <String>] [-CustomAttribute13 <String>] [-CustomAttribute14 <String>] [-CustomAttribute15 <String>] [-CustomAttribute2 <String>] [-CustomAttribute3 <String>] [-CustomAttribute4 <String>] [-CustomAttribute5 <String>] [-CustomAttribute6 <String>] [-CustomAttribute7 <String>] [-CustomAttribute8 <String>] [-CustomAttribute9 <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-EmailAddresses <ProxyAddressCollection>] [-EmailAddressPolicyEnabled <$true | $false>] [-ExpansionServer <String>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-MaxReceiveSize <Unlimited>] [-MaxSendSize <Unlimited>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-ReportToManagerEnabled <$true | $false>] [-ReportToOriginatorEnabled <$true | $false>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SamAccountName <String>] [-SendOofMessageToOriginatorEnabled <$true | $false>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-WindowsEmailAddress <SmtpAddress>]
Set-DistributionGroup [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-CreateDTMFMap <$true | $false>] [-CustomAttribute1 <String>] [-CustomAttribute10 <String>] [-CustomAttribute11 <String>] [-CustomAttribute12 <String>] [-CustomAttribute13 <String>] [-CustomAttribute14 <String>] [-CustomAttribute15 <String>] [-CustomAttribute2 <String>] [-CustomAttribute3 <String>] [-CustomAttribute4 <String>] [-CustomAttribute5 <String>] [-CustomAttribute6 <String>] [-CustomAttribute7 <String>] [-CustomAttribute8 <String>] [-CustomAttribute9 <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-EmailAddresses <ProxyAddressCollection>] [-EmailAddressPolicyEnabled <$true | $false>] [-ExpansionServer <String>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-Instance <DistributionGroup>] [-MaxReceiveSize <Unlimited>] [-MaxSendSize <Unlimited>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-ReportToManagerEnabled <$true | $false>] [-ReportToOriginatorEnabled <$true | $false>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SamAccountName <String>] [-SendOofMessageToOriginatorEnabled <$true | $false>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-WindowsEmailAddress <SmtpAddress>]
Descrizione dettagliata
I gruppi di distribuzione consentono di raggruppare dei destinatari in un singolo punto di contatto per i messaggi di posta elettronica. I gruppi di distribuzione non possono essere utilizzati per assegnare autorizzazioni a risorse di rete nel servizio directory di Active Directory. Il cmdlet Set-DistributionGroup consente di sovrascrivere le impostazioni esistenti oppure di aggiungere nuove impostazioni.
Per eseguire il cmdlet Set-DistributionGroup, è necessario utilizzare un account che disponga della seguente delega:
- Ruolo Exchange Recipient 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.DistributionGroupIdParameter |
Il parametro Identity consente di specificare l'oggetto che si desidera modificare. Il parametro Identity consente di accettare uno dei seguenti valori per il gruppo di distribuzione:
Il parametro Identity non può essere utilizzato nel caso in cui sia specificato il parametro Instance. |
AcceptMessagesOnlyFrom |
Facoltativo |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[] |
Il parametro AcceptMessagesOnlyFrom consente di specificare gli utenti della cassetta postale e i contatti abilitati alla posta che possono inviare messaggi di posta elettronica a questo gruppo di distribuzione. Il parametro AcceptMessagesOnlyFrom consente di accettare uno dei seguenti valori per i mittenti validi:
Per impostazione predefinita, il valore di questo parametro è vuoto. In talo modo, il gruppo di distribuzione accetta i messaggi di tutti gli utenti della cassetta postale e di tutti i contatti abilitati per la posta. |
AcceptMessagesOnlyFromDLMembers |
Facoltativo |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[] |
Il parametro AcceptMessagesOnlyFromDLMembers consente di specificare i gruppi di distribuzione a cui è consentito inviare messaggi di posta elettronica diretti a questo gruppo di distribuzione. È possibile utilizzare uno dei seguenti valori per i gruppi di distribuzione consentiti:
Per impostazione predefinita, il valore di questo parametro è vuoto. In tal modo il gruppo di distribuzione accetta messaggi da tutti i gruppi di distribuzione. |
Alias |
Facoltativo |
System.String |
Il parametro Alias consente di specificare l'alias dell'oggetto. Il valore Alias non può contenere spazi. |
CreateDTMFMap |
Facoltativo |
System.Boolean |
Questo parametro consente di specificare una mappa DTMF (Dual Tone Multi-Frequency) da creare per il gruppo di distribuzione. |
CustomAttribute1 |
Facoltativo |
System.String |
Il parametro CustomAttribute1 consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. |
CustomAttribute10 |
Facoltativo |
System.String |
Il parametro CustomAttribute10 consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. |
CustomAttribute11 |
Facoltativo |
System.String |
Il parametro CustomAttribute11 consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. |
CustomAttribute12 |
Facoltativo |
System.String |
Il parametro CustomAttribute12 consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. |
CustomAttribute13 |
Facoltativo |
System.String |
Il parametro CustomAttribute13 consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. |
CustomAttribute14 |
Facoltativo |
System.String |
Il parametro CustomAttribute14 consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. |
CustomAttribute15 |
Facoltativo |
System.String |
Il parametro CustomAttribute15 consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. |
CustomAttribute2 |
Facoltativo |
System.String |
Il parametro CustomAttribute2 consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. |
CustomAttribute3 |
Facoltativo |
System.String |
Il parametro CustomAttribute3 consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. |
CustomAttribute4 |
Facoltativo |
System.String |
Il parametro CustomAttribute4 consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. |
CustomAttribute5 |
Facoltativo |
System.String |
Il parametro CustomAttribute5 consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. |
CustomAttribute6 |
Facoltativo |
System.String |
Il parametro CustomAttribute6 consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. |
CustomAttribute7 |
Facoltativo |
System.String |
Il parametro CustomAttribute7 consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. |
CustomAttribute8 |
Facoltativo |
System.String |
Il parametro CustomAttribute8 consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. |
CustomAttribute9 |
Facoltativo |
System.String |
Il parametro CustomAttribute9 consente di specificare attributi personalizzati. È possibile utilizzare questi attributi per memorizzare informazioni aggiuntive. |
DisplayName |
Facoltativo |
System.String |
Il parametro DisplayName consente di specificare il nome del gruppo di distribuzione in Exchange Management Console e nell'elenco indirizzi globale (GAL, global address list) di Exchange. |
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 il parametro DomainController. |
EmailAddresses |
Facoltativo |
Microsoft.Exchange.Data.ProxyAddressCollection |
Il parametro EmailAddresses consente di specificare l'alias di posta elettronica del gruppo di distribuzione. È possibile utilizzare tutti i tipi di indirizzi di posta elettronica di Microsoft Exchange Server 2007 validi. È possibile specificare più valori per il parametro EmailAddresses, sotto forma di elenco delimitato da virgole. |
EmailAddressPolicyEnabled |
Facoltativo |
System.Boolean |
Il parametro EmailAddressPolicyEnabled consente di controllare l'applicazione dei criteri relativi agli indirizzi di posta elettronica a questo gruppo di distribuzione. I valori validi sono $true o $false. Il valore predefinito è $true. Per impostazione predefinita, tutti i criteri dell'indirizzo di posta elettronica applicabili vengono applicati a questo gruppo di distribuzione. |
ExpansionServer |
Facoltativo |
System.String |
Il parametro ExpansionServer consente di specificare il server di Exchange utilizzato per espandere il gruppo di distribuzione. Immettere il server di espansione come valore DN legacy di Exchange. Il comportamento predefinito è di utilizzare il computer di Exchange Server 2003 più vicino oppure il server di Exchange 2007 più vicino in cui è installato il ruolo del server Trasporto Hub. |
GrantSendOnBehalfTo |
Facoltativo |
Microsoft.Exchange.Configuration.Tasks.MailboxOrMailUserIdParameter[] |
Il parametro GrantSendOnBehalfTo consente di specificare un utente della cassetta postale abilitato all'invio per conto di questo gruppo di distribuzione. Il parametro GrantSendOnBehalfTo può assumere uno dei seguenti valori:
Per impostazione predefinita, il valore di GrantSendOnBehalfTo è vuoto. In tal modo nessun altro utente di cassetta postale dispone dell'autorizzazione per inviare per conto di questo gruppo di distribuzione. |
HiddenFromAddressListsEnabled |
Facoltativo |
System.Boolean |
Il parametro HiddenFromAddressListsEnabled consente di nascondere il gruppo di distribuzione da qualsiasi elenco di indirizzi di Exchange. I valori validi sono $true o $false. Il valore predefinito è $false. |
Instance |
Facoltativo |
Microsoft.Exchange.Data.Directory.Management.DistributionGroup |
Il parametro Instance consente di trasmettere l'intero oggetto al comando da elaborare. Viene utilizzato principalmente negli script in cui è necessario trasmettere l'intero oggetto al comando. Il parametro Instance non può essere utilizzato nel caso in cui sia specificato il parametro Identity. |
MaxReceiveSize |
Facoltativo |
Microsoft.Exchange.Data.Unlimited |
Il parametro MaxReceiveSize consente di impostare le dimensioni massime consentite per i messaggi di posta elettronica che possono essere inviati a questo gruppo di distribuzione. Nel caso venga immesso un valore, qualificarlo con una delle seguenti unità:
I valori non qualificati vengono considerati byte. I valori validi sono compresi tra 0 e 2147482624 byte. Per impostazione predefinita, il parametro MaxReceiveSize è impostato su |
MaxSendSize |
Facoltativo |
Microsoft.Exchange.Data.Unlimited |
Il parametro MaxSendSize consente di specificare le dimensioni massime consentite per i messaggi di posta elettronica che possono essere inviati da questo gruppo di distribuzione. Nel caso venga immesso un valore, qualificarlo con una delle seguenti unità:
I valori non qualificati vengono considerati byte. I valori validi sono compresi tra 0 e 2147482624 byte. Per impostazione predefinita, il parametro MaxSendSize è impostato su |
Nome |
Facoltativo |
System.String |
Il parametro Name consente di specificare il nome del gruppo di distribuzione. Il parametro Name consente di specificare il nome del gruppo di distribuzione nel campo Utenti e computer di Active Directory e anche nel campo Nome gruppo in Exchange Management Console. |
PrimarySmtpAddress |
Facoltativo |
Microsoft.Exchange.Data.SmtpAddress |
Il parametro PrimarySmtpAddress consente di specificare l'indirizzo di posta elettronica SMTP di risposta principale per il gruppo di distribuzione. È attivo solo se il gruppo di distribuzione dispone di più indirizzi di posta elettronica SMTP. |
RejectMessagesFrom |
Facoltativo |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[] |
Il parametro RejectMessagesFrom consente di specificare gli utenti della cassetta postale e i contatti abilitati alla posta a cui non è consentito inviare messaggi di posta elettronica a questo gruppo di distribuzione. È possibile utilizzare uno dei seguenti valori per i mittenti non consentiti:
Per impostazione predefinita, il valore di questo parametro è vuoto. In talo modo, il gruppo di distribuzione accetta i messaggi di tutti gli utenti della cassetta postale e di tutti i contatti abilitati per la posta. |
RejectMessagesFromDLMembers |
Facoltativo |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[] |
Il parametro RejectMessagesFromDLMembers consente di specificare i gruppi di distribuzione a cui non è consentito inviare messaggi di posta elettronica al gruppo di distribuzione. È possibile utilizzare uno dei seguenti valori per i gruppi di distribuzione non consentiti:
Per impostazione predefinita, il valore di questo parametro è vuoto. In tal modo il gruppo di distribuzione accetta messaggi da tutti i gruppi di distribuzione. |
ReportToManagerEnabled |
Facoltativo |
System.Boolean |
Il parametro ReportToManagerEnabled consente di inviare rapporti di recapito al gestore del gruppo di distribuzione. I valori validi sono $true o $false. Il valore predefinito è $false |
ReportToOriginatorEnabled |
Facoltativo |
System.Boolean |
Il parametro ReportToOriginatorEnabled consente di inviare rapporti di recapito ai mittenti dei messaggi di posta elettronica inviati a questo gruppo di distribuzione. I valori validi sono $true o $false. Il valore predefinito è $true. |
RequireSenderAuthenticationEnabled |
Facoltativo |
System.Boolean |
Il parametro RequireSenderAuthenticationEnabled richiede che i messaggi di posta elettronica siano recapitati da mittenti autenticati. Se il valore è $true, i messaggi vengono accettati solo dai mittenti autenticati. I valori validi sono $true o $false. Il valore predefinito è $true. |
SamAccountName |
Facoltativo |
System.String |
Il parametro SamAccountName consente di specificare il nome dei client dell'oggetto su cui sono in esecuzione sistemi operativi meno recenti. Il parametro SamAccountName viene visualizzato in Active Directory e in Exchange Management Console nel campo Nome gruppo (precedente a Windows 2000). |
SendOofMessageToOriginatorEnabled |
Facoltativo |
System.Boolean |
Il parametro SendOofMessageToOriginatorEnabled consente di inviare i messaggi Fuori sede ai mittenti dei messaggi di posta elettronica inviati a questo gruppo di distribuzione. I valori validi sono |
SimpleDisplayName |
Facoltativo |
System.String |
Il parametro SimpleDisplayName consente di visualizzare una descrizione alternativa dell'oggetto quando è consentito solo un set di caratteri limitato. Tale set di caratteri limitato è composto dai caratteri ASCII compresi tra il carattere 26 e il carattere 126. |
UMDtmfMap |
Facoltativo |
Microsoft.Exchange.Data.MultiValuedProperty |
Questo parametro consente di specificare se si intende creare una mappa DTMF definita dall'utente per il gruppo di distribuzione abilitato alla messaggistica unificata. |
WindowsEmailAddress |
Facoltativo |
Microsoft.Exchange.Data.SmtpAddress |
Il parametro WindowsEmailAddress consente di specificare il valore del campo Posta elettronica dell'oggetto Active Directory. |
Tipi di input
Tipi restituiti
Errori
Errore | Descrizione |
---|---|
|
|
Eccezioni
Eccezioni | Descrizione |
---|---|
|
|
Esempio
L'esempio di codice seguente mostra come utilizzare il comando Set-DistributionGroup per modificare il nome visualizzato di un gruppo di distribuzione esistente denominato Contabilità in Gruppo Contabilità.
Set-DistributionGroup -Identity "Accounting" -DisplayName "Accounting Group"