New-DistributionGroup

  • Articolo

 

Si applica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Ultima modifica dell'argomento: 2009-05-12

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

Sintassi

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

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 vengono utilizzati per consolidare gruppi di 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 Active Directory applicabili

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

Name

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.

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.

Type

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.

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.

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 consente di scrivere 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. Per questo parametro è possibile utilizzare uno dei seguenti valori:

  • Nome distinto (DN)

  • Nome canonico

  • GUID

  • Nome

  • Nome visualizzato

  • DN precedente di Exchange

  • Indirizzo di posta elettronica SMTP principale

OrganizationalUnit

Facoltativo

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.

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.

UseRusServer

Facoltativo

System.String
noteNota:
Questo parametro è disponibile solo in Exchange Server 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 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 eseguire sull'oggetto. Il parametro WhatIf consente di visualizzare le modifiche che verrebbero apportate senza applicarle. Con il parametro WhatIf non è necessario specificare un valore.

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"