Get-User

  • Artikel

 

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-User, um alle Benutzer aus der Gesamtstruktur abzurufen, die den angegebenen Bedingungen entsprechen.

Syntax

get-User [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

get-User [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

get-User [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

Detaillierte Beschreibung

Es sind keine zusätzlichen Parameter erforderlich. Es darf jedoch nur einer der folgenden Parameter in einem Get-User-Befehl verwendet werden: Identity, Filter oder Anr.

Damit Sie das Cmdlet Get-User 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 das Konto 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 Filter-Parameter gibt eine Reihe von Attributen an, die die von der Abfrage zurückgegebenen Empfänger einschränkt.

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

Identity

Optional

Microsoft.Exchange.Configuration.Tasks.UserIdParameter

Der Parameter Identity akzeptiert einen der folgenden Werte:

  • GUID

  • Distinguished Name (DN)

  • Domäne\Konto

  • Benutzerprinzipalname (User Principal Name, UPN)

  • Legacy-Exchange-DN

  • SMTP-Adresse (Simple Mail Transfer Protocol)

  • Alias

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:

  • Der Parameter DomainController kann nicht verwendet werden. Der Befehl verwendet automatisch einen geeigneten globalen Katalogserver.

  • Für den Parameter Identity kann nur der DN verwendet werden. Andere Formen der Identifikation, wie etwa Aliasnamen oder GUIDs, werden nicht akzeptiert.

  • Die Parameter OrganizationalUnit und Identity können nicht zusammen verwendet werden.

  • Der Parameter Credential kann nicht verwendet werden.

OrganizationalUnit

Optional

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Der OrganizationalUnit-Parameter gibt Objekte nur aus der angegebenen Organisationseinheit (Organizational Unit, OU) zurück.

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 Parameter lauten:

  • ConferenceRoomMailbox

  • DisabledUser

  • EquipmentMailbox

  • LegacyMailbox

  • LinkedMailbox

  • UserMailbox

  • MailUser

  • User

ResultSize

Optional

Microsoft.Exchange.Data.Unlimited

Der ResultSize-Parameter legt die maximale Anzahl zurückzugebender Ergebnisse fest.

SortBy

Optional

System.String

Der SortBy-Parameter sortiert ein einzelnes Attribut in aufsteigender Reihenfolge.

Eingabetypen

Rückgabetypen

Fehler

Fehler Beschreibung

 

 

Ausnahmen

Ausnahmen Beschreibung

 

 

Beispiel

Im ersten Beispiel werden Informationen über die Benutzer in der Organisationseinheit "Marketing" abgerufen.

Im zweiten Beispiel wird der Parameter Filter verwendet, um Informationen über alle Benutzer abzurufen, bei denen sich das Wort "Manager" am Ende ihres Titels befindet.

Get-User -OrganizationalUnit "Marketing"
Get-User -Filter {Title -like '*Manager'}

Sie können ein beliebiges Active Directory-Benutzerattribut verwenden, um eine Filterzeichenfolge für den Parameter Filter im Cmdlet Get-User zu erstellen. Weitere Informationen zu den in der Filterzeichenfolge zu verwendenden Vergleichsoperatoren finden Sie unter Vergleichsoperatoren.