Get-DynamicDistributionGroup
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Letztes Änderungsdatum des Themas: 2010-04-27
Verwenden Sie das Cmdlet Get-DynamicDistributionGroup, um die Einstellungen einer vorhandenen dynamischen Verteilergruppen abzurufen.
Syntax
Get-DynamicDistributionGroup [-Identity <DynamicGroupIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-ManagedBy <GeneralRecipientIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]
Get-DynamicDistributionGroup [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-ManagedBy <GeneralRecipientIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]
Get-DynamicDistributionGroup [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-ManagedBy <GeneralRecipientIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-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. Microsoft Exchange), um E-Mail-Nachrichten an Sammlungen von Benutzern zu senden. Sie können mithilfe des Cmdlets Get-DynamicDistributionGroup die Einstellungen einer vorhandenen dynamischen Verteilergruppen im Active Directory-Verzeichnisdienst abrufen.
Damit Sie das Cmdlet Get-DynamicDistributionGroup 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 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 von Active Directory 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.DynamicGroupIdParameter |
Der Parameter Identity der Verteilergruppe akzeptiert eins der folgenden Formate:
|
IgnoreDefaultScope |
Optional |
System.Management.Automation.SwitchParameter |
Mit dem Parameter IgnoreDefaultScope wird der Befehl angewiesen, die Standardeinstellung für den Empfängerbereich für die Exchange-Verwaltungsshell zu ignorieren und die ganze Gesamtstruktur als Bereich zu verwenden. Dadurch kann der Befehl auf Active Directory-Objekte zugreifen, die sich aktuell nicht im Standardbereich befinden. Die Verwendung des Parameters IgnoreDefaultScope bringt die folgenden Einschränkungen mit sich:
|
ManagedBy |
Optional |
Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter |
Der Parameter ManagedBy gibt den DN 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. |
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
Im Folgenden finden Sie ein Beispiel für den Befehl Get-DynamicDistributionGroup. In diesem Beispiel ruft der Befehl Get-DynamicDistributionGroup die dynamische Verteilergruppe Marketing ab und leitet das Objekt dann mittels Pipelining in den Befehl Format-List um, um die Informationen zur dynamischen Verteilergruppe anzuzeigen.
Get-DynamicDistributionGroup -Identity "Marketing" | Format-List