Condividi tramite


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:

  • Nome distinto (DN, Distinguished name)

  • Nome standard

  • GUID

  • Nome

  • Nome visualizzato

  • Alias

  • Exchange DN

  • Indirizzo principale SMTP (Simple Mail Transfer Protocol)

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:

  • Nome distinto (DN, Distinguished name)

  • Nome canonico

  • GUID

  • Nome

  • Nome visualizzato

  • Alias

  • Exchange DN

  • Indirizzo di posta elettronica SMTP principale

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:

  • Nome distinto (Distinguished Name, DN)

  • Nome canonico

  • GUID

  • Nome

  • Nome visualizzato

  • Nome distinto legacy di Exchange

  • Indirizzo di posta elettronica SMTP principale

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:

  • Nome distinto (Distinguished Name, DN)

  • GUID

  • Nome

  • Nome visualizzato

  • Nome canonico

  • Nome distinto legacy di Exchange

  • Alias

  • Indirizzo di posta elettronica SMTP principale

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:

  • Non è possibile utilizzare il parametro DomainController. Il comando utilizzerà automaticamente un server di catalogo globale appropriato.

  • È possibile utilizzare solo il DN per il parametro Identity. Non sono accettate altre forme di identificazione, ad esempio alias o GUID.

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:

  • Nome distinto (Distinguished Name, DN)

  • Nome canonico

  • GUID

  • Nome

  • Nome visualizzato

  • Nome distinto legacy di Exchange

  • Indirizzo di posta elettronica SMTP principale

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à:

  • B (byte)

  • KB (kilobyte)

  • MB (megabyte)

  • GB (gigabyte)

  • TB (terabyte)

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 unlimited.

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à:

  • B (byte)

  • KB (kilobyte)

  • MB (megabyte)

  • GB (gigabyte)

  • TB (terabyte)

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 unlimited.

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:

  • Nome distinto (Distinguished Name, DN)

  • Nome canonico

  • GUID

  • Nome

  • Nome visualizzato

  • Nome distinto legacy di Exchange

  • Indirizzo di posta elettronica SMTP principale

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:

  • Nome distinto (Distinguished Name, DN)

  • Nome canonico

  • GUID

  • Nome

  • Nome visualizzato

  • Nome distinto legacy di Exchange

  • Indirizzo di posta elettronica SMTP principale

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 $true o $false. Il valore predefinito è $false.

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

noteNota:
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 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"