Get-DistributionGroup (RTM)
Gilt für: Exchange Server 2007
Letztes Änderungsdatum des Themas: 2008-02-27
Verwenden Sie das Cmdlet Get-DistributionGroup, um eine Abfrage nach vorhandenen Verteilergruppen auszuführen.
Syntax
Get-DistributionGroup [-Identity <DistributionGroupIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-ManagedBy <GeneralRecipientIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
Get-DistributionGroup [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-ManagedBy <GeneralRecipientIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
Get-DistributionGroup [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-ManagedBy <GeneralRecipientIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
Detaillierte Beschreibung
Sie können mithilfe von Verteilergruppen E-Mail-Verteilerlisten und Sicherheitsgruppen erstellen, um freigegebenen Ressourcen Berechtigungen zuzuweisen. Verteilergruppen können nur mit E-Mail-Anwendungen verwendet werden (wie z. B. Exchange), um E-Mail-Nachrichten an Sammlungen von Benutzern zu senden. Sie können mit dem Cmdlet Get-DistributionGroup Abfragen nach vorhandenen Verteilergruppen durchführen.
Damit Sie das Cmdlet Get-DistributionGroup ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:
- Exchange-Administrator mit Leserechten (Rolle)
Weitere Informationen zu Berechtigungen, zum Delegieren von Rollen und zu den Rechten, die für die Verwaltung von Microsoft Exchange Server 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
ANR |
Optional |
System.String |
Der Parameter ANR zeigt an, dass das Argument mithilfe der Auflösung mehrdeutiger Namen (Ambiguous Name Resolution, ANR) aufgelöst wird. |
Credential |
Optional |
System.Management.Automation.PSCredential |
Der Parameter Credential gibt die Domäne und den Benutzernamen des Kontos an, das zum Lesen des Active Directory-Verzeichnisdiensts verwendet wird. |
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
Um den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Domänencontrollers anzugeben, der Daten aus Active Directory abruft, fügen Sie dem Befehl den Parameter DomainController hinzu. |
Filter |
Optional |
System.String |
Der Parameter Filter gibt den OPath-Filter an, der zum Filtern von Empfängern verwendet wird. Weitere Informationen zu den filterbaren Eigenschaften finden Sie unter Filterbare Eigenschaften für den Parameter „-Filter“. |
Identity |
Optional |
Microsoft.Exchange.Configuration.Tasks.DistributionGroupIdParameter |
Der Parameter Identity der Verteilergruppe akzeptiert eins der folgenden Formate:
|
ManagedBy |
Optional |
Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter |
Der Parameter ManagedBy gibt den Distinguished Name des Benutzers oder Kontakts an, von dem die Gruppe verwaltet wird. |
OrganizationalUnit |
Optional |
Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter |
Der Parameter OrganizationalUnit beschränkt Ergebnisse auf einen bestimmten Container einer Organisationseinheit. |
ReadFromDomainController |
Optional |
System.Management.Automation.SwitchParameter |
Der Parameter ReadFromDomainController gibt an, dass die Benutzerinformationen von einem Domänencontroller in der Domäne des Benutzers abgerufen werden. Wenn Sie festlegen, dass der Empfängerbereich alle Empfänger in der Gesamtstruktur enthalten soll, und Sie diesen Parameter nicht verwenden, werden die Benutzerinformationen möglicherweise aus einem globalen Katalog mit veralteten Informationen entnommen. Wenn Sie diesen Parameter verwenden, sind zum Abrufen der Informationen möglicherweise mehrere Lesevorgänge erforderlich. Hinweis Standardmäßig ist der Empfängerbereich auf die Domäne festgelegt, in der sich Ihre Server mit Exchange befinden. |
RecipientTypeDetails |
Optional |
Microsoft.Exchange.Data.Directory.Recipient.RecipientTypeDetails[] |
Der Parameter RecipientTypeDetails legt den Typ der Empfänger fest, die zurückgegeben werden. Empfängertypen in Microsoft Exchange Server 2007 werden in Empfängertypen und -untertypen eingeteilt. Jeder Empfängertyp enthält alle allgemeinen Eigenschaften aller Untertypen. Der Typ UserMailbox stellt beispielsweise ein Benutzerkonto in Active Directory mit einem zugeordneten Postfach dar. Da es mehrere Postfachtypen gibt, wird jeder Postfachtyp über den Parameter RecipientTypeDetails identifiziert. Bei einem Konferenzraum-Postfach ist beispielsweise RecipientTypeDetails auf ConferenceRoomMailbox festgelegt, während bei einem Benutzerpostfach RecipientTypeDetails auf UserMailbox festgelegt ist. Die verfügbaren Empfängertypdetails für diesen Befehl lauten:
|
ResultSize |
Optional |
Microsoft.Exchange.Data.Unlimited |
Der Parameter ResultSize gibt die maximale Anzahl der Empfängerobjekte an, die zurückgegeben werden. |
SortBy |
Optional |
System.String |
Das Attribut SortBy wird zum Sortieren der Ergebnisse verwendet. |
Eingabetypen
Rückgabetypen
Fehler
| Fehler | Beschreibung |
|---|---|
|
Ausnahmen
| Ausnahmen | Beschreibung |
|---|---|
|
Beispiel
Der folgende Code ist ein Beispiel für den Befehl Get-DistributionGroup. In diesem Beispiel ruft der Befehl Get-DistributionGroup die Gruppe Distribution Group1 ab und leitet das Objekt dann mittels Pipelining in den Befehl Format-List um, um die Informationen zur Verteilergruppe anzuzeigen.
Get-DistributionGroup -Identity "Distribution Group1" | Format-List