Freigeben über

Get-Group (RTM)

  • Artikel

 

Gilt für: Exchange Server 2007

Letztes Änderungsdatum des Themas: 2007-06-05

Verwenden Sie das Cmdlet Get-Group, um eine Abfrage nach vorhandenen Gruppen durchzuführen.

Syntax

Get-Group [-Identity <GroupIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

Get-Group [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

Get-Group [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

Detaillierte Beschreibung

Das Cmdlet Get-Group gibt alle vorhandenen Gruppen in Microsoft Windows zurück, die den angegebenen Filterparametern entsprechen.

Damit Sie das Cmdlet Get-Group 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 das Konto an, das zum Lesen des Active Directory-Verzeichnisdiensts verwendet werden soll. Dies ist besonders nützlich beim Angeben des globalen Katalogs. Das Kennwort sollte auf sichere Weise angefordert werden.

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 Filter an, der zum Filtern von Empfängern verwendet werden soll.

Weitere Informationen zu den filterbaren Eigenschaften finden Sie unter Filterbare Eigenschaften für den Parameter „-Filter“.

Identity

Optional

Microsoft.Exchange.Configuration.Tasks.GroupIdParameter

Der Parameter Identity der Verteilergruppe akzeptiert eins der folgenden Formate:

  • GUID

  • Distinguished Name (DN)

  • Benutzerprinzipalname (User Principal Name, UPN)

  • LegacyExchangeDN

  • Domäne\Kontoname

  • Alias

OrganizationalUnit

Optional

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Der Parameter OrganizationalUnit beschränkt Ergebnisse auf einen bestimmten Container einer Organisationseinheit (OU).

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:

  • MailEnabledContact

  • MailEnabledForestContact

  • NonUniversalGroup

  • UniversalDistributionGroup

  • UniversalSecurityGroup

ResultSize

Optional

Microsoft.Exchange.Data.Unlimited

Der Parameter ResultSize gibt die maximale Anzahl der Mitglieder 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-Group. In diesem Beispiel wird der Befehl Get-Group ohne Parameter verwendet, um alle Gruppen in Active Directory zurückzugeben.

Get-Group