Share via

New-DistributionGroup (RTM)

  • Artikel

 

Gilt für: Exchange Server 2007

Letztes Änderungsdatum des Themas: 2007-06-05

Verwenden Sie das Cmdlet New-DistributionGroup, um eine neue Verteilergruppe zu erstellen.

Syntax

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

Detaillierte Beschreibung

Sie können das Cmdlet New-DistributionGroup verwenden, um neue Active Directory-Gruppenobjekte der folgenden Typen zu erstellen:

  • E-Mail-aktivierte universelle Sicherheitsgruppe

  • Universelle Verteilergruppe

Verteilergruppen werden zum Konsolidieren von Empfängergruppen an einem einzigen Kontaktpunkt für E-Mail-Nachrichten verwendet. Verteilergruppen können nicht zum Zuweisen von Berechtigungen zu Netzwerkressourcen im Active Directory-Verzeichnisdienst verwendet werden.

Damit Sie das Cmdlet New-DistributionGroup ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:

  • die Rolle Exchange-Empfängeradministrator

  • Konten-Operator-Rolle für die entsprechenden Active Directory-Container

Weitere Informationen zu Berechtigungen, zum Delegieren von Rollen und zu den Rechten, die für die Verwaltung von Exchange Server 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.

Parameter

Parameter Erforderlich Typ Beschreibung

Name

Erforderlich

System.String

Dieser Parameter gibt den Namen der neuen Verteilergruppe an. Der Wert, der im Parameter Name angegeben wird, wird auch für DisplayName verwendet, wenn der Parameter DisplayName nicht angegeben wird.

Der Wert Name darf 64 Zeichen nicht überschreiten.

Wenn die Werte von Name und DisplayName unterschiedlich sind:

  • Name gibt den Namen der Verteilergruppe in Active Directory-Benutzer und -Computer und im Feld Gruppenname in der Exchange-Verwaltungskonsole an.

  • DisplayName gibt den Namen der Verteilergruppe in der Exchange-Verwaltungskonsole und in der globalen Adressliste (GAL) von Exchange an.

OrganizationalUnit

Erforderlich

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Dieser Parameter gibt an, wo die Verteilergruppe in Active Directory erstellt werden soll, indem die Syntax mit kanonischem Namen verwendet wird.

SamAccountName

Erforderlich

System.String

Dieser Parameter gibt den Namen für Clients des Objekts an, auf denen ältere Betriebssysteme ausgeführt werden. Der Parameter SamAccountName wird in Active Directory und in der Exchange-Verwaltungskonsole im Feld Gruppenname (Prä-Windows 2000) angezeigt. Wenn der Alias-Parameter nicht angegeben wird, gelten die folgenden Bedingungen:

  • Der Wert von SAMAccountName wird für den Wert des Alias-Parameters verwendet, dabei werden alle Leerzeichen in Unterstriche umgewandelt.

  • SAMAccountName, mit in Unterstriche umgewandelten Leerzeichen, wird verwendet, um die primäre SMTP-E-Mail-Adresse (Simple Mail Transfer Protocol) des Objekts zu erzeugen.

Typ

Erforderlich

Microsoft.Exchange.Management.RecipientTasks.GroupType

Dieser Parameter gibt den Gruppentyp an, der in Active Directory erstellt werden soll. Der Gültigkeitsbereich der Gruppe ist immer Universell. Gültige Werte sind Distribution und Security.

Alias

Optional

System.String

Dieser Parameter kann verwendet werden, um den Aliasnamen der Verteilergruppe anzugeben. Der Alias-Parameter wird anschließend verwendet, um die primäre SMTP-E-Mail-Adresse des Objekts zu erzeugen. Der Wert von Alias darf keine Leerzeichen enthalten. Wenn Alias nicht angegeben wird, wird der Wert von SAMAccountName verwendet, um die primäre SMTP-E-Mail-Adresse zu erzeugen; dabei werden alle Leerzeichen in Unterstriche umgewandelt.

DisplayName

Optional

System.String

Dieser Parameter kann verwendet werden, um den Namen der Verteilergruppe in der Exchange-Verwaltungskonsole und in der Exchange-GAL anzugeben. Wenn der DisplayName-Parameter nicht angegeben wird, wird der Wert des Name-Parameters für DisplayName verwendet.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

Um den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Domänencontrollers anzugeben, der diese Konfigurationsänderung in Active Directory schreibt, fügen Sie den Parameter DomainController hinzu.

ManagedBy

Optional

Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter

Dieser Parameter kann verwendet werden, um den Namen des Postfachbenutzers, der E-Mail-aktivierten Gruppe oder des E-Mail-aktivierten Kontakts anzugeben, der auf der Registerkarte Verwaltet von des Objekts Active Directory angezeigt wird. Für diesen Parameter kann jeder der folgenden Werte verwendet werden:

  • Distinguished Name (DN)

  • Kanonischer Name

  • GUID

  • Name

  • Anzeigename

  • Legacy-Exchange-DN

  • Primäre SMTP-E-Mail-Adresse

TemplateInstance

Optional

System.Management.Automation.PSObject

Wenn ein vorhandenes Objekt an diesen Parameter übergeben wird, verwendet das Cmdlet dieses Objekt zum Erstellen einer Kopie des Objekts.

Eingabetypen

Rückgabetypen

Fehler

Fehler Beschreibung

 

 

Ausnahmen

Ausnahmen Beschreibung

 

 

Beispiel

Im folgenden Codebeispiel wird gezeigt, wie das Cmdlet New-DistributionGroup verwendet wird, um eine neue E-Mail-aktivierte universelle Sicherheitsgruppe zu erstellen, die folgende Parameter aufweist:

  • Der Name der Gruppe soll Managers sein.

  • Die Gruppe soll im Container Users in der Domäne Contoso.com erstellt werden.

  • Der SAM-Kontoname der Gruppe soll Managers sein.

  • Der Gruppentyp soll Security sein.

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