Set-DistributionGroup
Si applica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Ultima modifica dell'argomento: 2010-10-20
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>] [-Confirm [<SwitchParameter>]] [-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>] [-IgnoreDefaultScope <SwitchParameter>] [-ManagedBy <GeneralRecipientIdParameter>] [-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>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]
Set-DistributionGroup [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-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>] [-IgnoreDefaultScope <SwitchParameter>] [-Instance <DistributionGroup>] [-ManagedBy <GeneralRecipientIdParameter>] [-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>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-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 Microsoft 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 delle cassette postali e i contatti di posta elettronica che possono inviare messaggi di posta elettronica a questo gruppo di distribuzione. È inoltre possibile specificare Microsoft Exchange come destinatario valido per questo parametro. Se si configura un gruppo di distribuzione in modo che vengano accettati solo i messaggi dal destinatario Microsoft Exchange, verranno ricevuti esclusivamente i messaggi generati dal sistema. Il parametro AcceptMessagesOnlyFrom consente di accettare uno dei seguenti valori per i mittenti validi:
Per impostazione predefinita, il valore di questo parametro è vuoto. In tal modo il gruppo di distribuzione accetta messaggi da tutti i mittenti. |
||
AcceptMessagesOnlyFromDLMembers |
Facoltativo |
Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[] |
Il parametro AcceptMessagesOnlyFromDLMembers consente di specificare i gruppi di distribuzione i cui membri sono autorizzati a 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 mittenti. |
||
Alias |
Facoltativo |
System.String |
Il parametro Alias consente di specificare l'alias dell'oggetto. Il valore Alias non può contenere spazi. |
||
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. |
||
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. Importante Exchange 2007 non convalida gli indirizzi personalizzati per una formattazione corretta. È necessario assicurarsi che l'indirizzo personalizzato specificato sia conforme a i requisiti di formato per tale tipo di indirizzo. Poiché gli indirizzi X.400 sono considerati indirizzi personalizzati in Exchange 2007, anch'essi non vengono convalidati. Quindi, è necessario utilizzare la sintassi corretta quando si specificano gli indirizzi X.400. |
||
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.RecipientIdParameter |
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. |
||
IgnoreDefaultScope |
Facoltativo |
System.Management.Automation.SwitchParameter |
Il parametro IgnoreDefaultScope consente di indicare al comando di ignorare l'impostazione dell'ambito destinatari predefinita di Exchange Management Shell e di utilizzare l'intera foresta come ambito. Ciò consente al comando di accedere agli oggetti di Active Directory che non si trovano correntemente nell'ambito predefinito. L'utilizzo del parametro IgnoreDefaultScope presenta le seguenti restrizioni:
|
||
Instance |
Facoltativo |
Microsoft.Exchange.Data.Directory.Management.DistributionGroup |
Il parametro Instance consente di trasmettere un oggetto selezionato al comando per l'elaborazione. Viene utilizzato principalmente negli script in cui è necessario passare al comando un oggetto selezionato. Il parametro Instance non può essere utilizzato nel caso in cui sia specificato il parametro Identity. |
||
ManagedBy |
Facoltativo |
Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter |
Il parametro ManagedBy specifica il nome dell'utente della cassetta postale, del gruppo o del contatto abilitato alla posta visualizzato nella scheda Gestito da dell'oggetto Active Directory. È possibile utilizzare uno dei seguenti valori per il parametro:
|
||
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 |
||
Name |
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 limitato di caratteri si compone dei seguenti caratteri: abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789\"()+,-./:? |
||
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. |
||
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 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. |
||
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"