Condividi tramite

New-DistributionGroup (RTM)

  • Articolo

 

Si applica a: Exchange Server 2007

Ultima modifica dell'argomento: 2007-06-05

Il cmdlet New-DistributionGroup consente di creare un nuovo gruppo di distribuzione.

Sintassi

New-DistributionGroup -Name <String> -OrganizationalUnit <OrganizationalUnitIdParameter> -SamAccountName <String> -Type <Distribution | Security> [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-ManagedBy <GeneralRecipientIdParameter>] [-TemplateInstance <PSObject>]

Descrizione dettagliata

È possibile utilizzare il cmdlet New-DistributionGroup per creare nuovi oggetti gruppo di Active Directory dei seguenti tipi:

  • Gruppo di protezione universale abilitato alla posta

  • Gruppo di distribuzione universale

I gruppi di distribuzione consentono di raggruppare dei destinatari in un singolo punto di contatto per i messaggi di posta elettronica. Inoltre, non possono essere utilizzati per assegnare autorizzazioni alle risorse di rete nel servizio directory di Active Directory.

Per eseguire il cmdlet New-DistributionGroup, è necessario utilizzare un account che disponga della seguente delega:

  • Ruolo Exchange Recipient Administrator

  • Ruolo Account Operator per i contenitori di Active Directory appropriati

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

Nome

Obbligatorio

System.String

Questo parametro consente di specificare il nome del nuovo gruppo di distribuzione. Il valore specificato nel parametro Name viene utilizzato anche per DisplayName, se il parametro DisplayName non è stato specificato.

Il valore del parametro Name non può superare i 64 caratteri.

Se i valori dei parametri Name e DisplayName sono diversi:

  • Il parametro Name consente di specificare il nome del gruppo di distribuzione in Utenti e computer di Active Directory e nel campo Nome gruppo in Exchange Management Console.

  • DisplayName consente di specificare il nome del gruppo di distribuzione in Exchange Management Console e nell'elenco indirizzi globale di Exchange.

OrganizationalUnit

Obbligatorio

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Questo parametro consente di specificare la posizione di creazione del gruppo di distribuzione in Active Directory utilizzando la sintassi del nome canonico.

SamAccountName

Obbligatorio

System.String

Questo parametro consente di specificare il nome dei client dell'oggetto che eseguono sistemi operativi precedenti. Il parametro SamAccountName viene visualizzato in Active Directory e in Exchange Management Console nel campo Nome gruppo (precedente a Windows 2000). Se il parametro Alias non viene specificato, le condizioni seguenti sono vere.

  • Il valore di SAMAccountName viene utilizzato per il valore del parametro Alias, con gli eventuali spazi convertiti in carattere di sottolineatura.

  • SAMAccountName, con eventuali spazi convertiti in caratteri di sottolineatura, viene utilizzato per generare l'indirizzo di posta elettronica SMTP (Simple Mail Transfer Protocol) principale dell'oggetto.

Tipo

Obbligatorio

Microsoft.Exchange.Management.RecipientTasks.GroupType

Questo parametro consente di specificare il tipo di gruppo che verrà creato in Active Directory. L'ambito del gruppo è sempre universale. I valori validi sono Distribution o Security.

Alias

Facoltativo

System.String

Questo parametro può essere utilizzato per specificare l'alias del gruppo di distribuzione. Il parametro Alias viene quindi utilizzato per generare l'indirizzo di posta elettronica SMTP principale dell'oggetto. Il valore del parametro Alias non può includere spazi. Se il parametro Alias non viene specificato, il valore di SAMAccountName viene utilizzato per generare l'indirizzo di posta elettronica SMTP principale, con eventuali spazi convertiti in caratteri di sottolineatura.

DisplayName

Facoltativo

System.String

Questo parametro può essere utilizzato per specificare il nome del gruppo di distribuzione in Exchange Management Console e nell'elenco indirizzi globale di Exchange. Se il parametro DisplayName non viene specificato, il valore del parametro Name viene utilizzato per DisplayName.

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.

ManagedBy

Facoltativo

Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter

Questo parametro può essere utilizzato per specificare il nome dell'utente della cassetta postale, il gruppo o il contatto abilitato all'utilizzo della posta visualizzati 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

TemplateInstance

Facoltativo

System.Management.Automation.PSObject

Se a questo parametro viene fornito un oggetto esistente, tale oggetto viene utilizzato per creare una copia dell'oggetto stesso.

Tipi di input

Tipi restituiti

Errori

Errore Descrizione

 

 

Eccezioni

Eccezioni Descrizione

 

 

Esempio

Nel seguente codice di esempio viene mostrato come utilizzare il cmdlet New-DistributionGroup per creare un nuovo gruppo di protezione universale abilitato per la posta con i seguenti parametri:

  • Il nome del gruppo sarà "Managers".

  • Il gruppo verrà creato nel contenitore degli utenti nel dominio Contoso.com.

  • Il nome account SAM del gruppo sarà "Managers".

  • Il tipo di gruppo sarà Security.

New-DistributionGroup -Name "Managers" -OrganizationalUnit "contoso.com/Users" -SAMAccountName "Managers" -Type "Security"