New-DistributionGroup

  • Artikel

 

Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Letztes Änderungsdatum des Themas: 2009-05-12

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

Syntax

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>]]

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:

  • Exchange-Empfängeradministrator-Rolle

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

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.

Type

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.

Confirm

Optional

System.Management.Automation.SwitchParameter

Der Confirm-Parameter bewirkt eine Unterbrechung der Befehlsausführung und zwingt Sie, die Aktion des Befehls zu bestätigen, bevor die Verarbeitung fortgesetzt wird. Für den Confirm-Parameter muss kein Wert angegeben werden.

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

OrganizationalUnit

Optional

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.

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.

UseRusServer

Optional

System.String
noteHinweis:
Dieser Parameter steht nur in Exchange Server 2007 SP2 zur Verfügung.

Der Parameter UseRusServer weist den Befehl an, den angegebenen Postfachserver, auf dem der Adresslistendienst ausgeführt wird, zum Abrufen und Festlegen von Postfach- und Active Directory-Benutzerattributen zu verwenden.

Der Adresslistendienst ist eine Komponente des Exchange-Systemaufsichtsdiensts. Der Adresslistendienst erstellt und verwaltet Exchange-spezifische Attributwerte in Active Directory. Sie können den Adresslistendienst zum Aktualisieren von Empfängerobjekten in einer Domäne mithilfe bestimmter Informationen verwenden, z. B. anhand von Adresslistenmitgliedschaft und E-Mail-Adressen.

WhatIf

Optional

System.Management.Automation.SwitchParameter

Der Parameter WhatIf weist den Befehl an, die für das Objekt ausgeführten Aktionen lediglich zu simulieren. Durch Verwendung des WhatIf-Parameters können Sie eine Vorschau der Änderungen anzeigen, ohne diese Änderungen wirklich übernehmen zu müssen. Für den WhatIf-Parameter muss kein Wert angegeben werden.

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"