Get-User
Gilt für: Exchange Server 2010 SP2
Letztes Änderungsdatum des Themas: 2011-08-30
Verwenden Sie das Cmdlet Get-User, um alle Benutzer aus der Gesamtstruktur abzurufen, die den angegebenen Bedingungen entsprechen.
get-User [-Identity <UserIdParameter>] [-Arbitration <SwitchParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-Organization <OrganizationIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
get-User [-Anr <String>] [-Arbitration <SwitchParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-Organization <OrganizationIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. In diesem Thema sind zwar alle Parameter für das Cmdlet aufgeführt, aber Sie verfügen möglicherweise nicht über Zugriff auf einige Parameter, falls diese nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Informationen zu den von Ihnen benötigten Berechtigungen finden Sie unter "Berechtigungen für die Empfängerbereitstellung" im Thema Postfachberechtigungen.
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
|
Anr |
Optional |
System.String |
Der Parameter Anr gibt eine Zeichenfolge an, für die eine Suche zur Auflösung eines nicht eindeutigen Namens (Ambiguous Name Resolution, ANR) durchgeführt wird. Sie können eine Teilzeichenfolge angeben und nach Objekten mit einem Attribut suchen, das der Zeichenfolge entspricht. Die gesuchten Standardattribute umfassen:
|
|
Arbitration |
Optional |
System.Management.Automation.SwitchParameter |
Der Parameter Arbitration gibt an, dass es sich bei dem Postfach, für das Sie den Befehl ausführen, um ein Vermittlungspostfach handelt. Vermittlungspostfächer werden zum Verwalten des Genehmigungsworkflows verwendet. Ein Vermittlungspostfach wird z. B. für die Verarbeitung moderierter Empfänger und für die Genehmigung von Verteilergruppenmitgliedschaften verwendet. |
|
Credential |
Optional |
System.Management.Automation.PSCredential |
Der Parameter Credential gibt das Konto an, das zum Abrufen der Informationen aus Active Directory verwendet wird. Dieser Parameter erfordert die Erstellung und Übergabe eines Anmeldeinformationsobjekts. Dieses Anmeldeinformationsobjekt wird mithilfe des Cmdlets Get-Credential erstellt. Weitere Informationen finden Sie unter Get-Credential. |
|
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
Der Parameter DomainController gibt den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Domänencontrollers an, der Daten aus Active Directory abruft. |
|
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.UserIdParameter |
Der Parameter Identity gibt die Identität des Benutzerobjekts an. Dieser Parameter akzeptiert die folgenden Werte:
|
|
IgnoreDefaultScope |
Optional |
System.Management.Automation.SwitchParameter |
Der Parameter IgnoreDefaultScope weist den Befehl an, die Standardeinstellung für den Empfängerbereich für die Exchange-Verwaltungsshell-Sitzung zu ignorieren und die vollständige 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:
|
|
Organization |
Optional |
Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter |
Dieser Parameter ist für mehrinstanzenfähige Bereitstellungen verfügbar. Für lokale Bereitstellungen ist er nicht verfügbar. Weitere Informationen zu mehrinstanzenfähigen Bereitstellungen finden Sie unter Unterstützung der Mehrinstanzenfähigkeit. Der Parameter Organization gibt die Organisation an, in der die Aktion ausgeführt wird. Dieser Parameter akzeptiert keine Platzhalterzeichen, und Sie müssen den genauen Namen der Organisation verwenden. |
|
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. Anmerkung:
Standardmäßig ist der Empfängerbereich auf die Domäne festgelegt, die die Exchange-Server hostet.
|
|
RecipientTypeDetails |
Optional |
Microsoft.Exchange.Data.Directory.Recipient.RecipientTypeDetails[] |
Der Parameter RecipientTypeDetails gibt den Typ der Empfänger an, die zurückgegeben werden sollen. Empfängertypen werden in Typen 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 durch den Parameter RecipientTypeDetails identifiziert. Bei einem Konferenzraum-Postfach ist beispielsweise RecipientTypeDetails auf "ConferenceRoomMailbox" festgelegt, während bei einem Benutzerpostfach RecipientTypeDetails auf "UserMailbox" festgelegt ist. Folgende Werte können verwendet werden:
|
|
ResultSize |
Optional |
Microsoft.Exchange.Data.Unlimited |
Der Parameter ResultSize gibt die maximale Anzahl zurückzugebender Ergebnisse an. |
|
Sortby |
Optional |
System.String |
Der Parameter SortBy gibt das Sortierattribut an. Dieser Parameter sortiert nach einem einzelnen Attribut in aufsteigender Reihenfolge. |
Eingabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets (möglicherweise in englischer Sprache). Wenn das Feld mit dem Eingabetyp für ein Cmdlet leer ist, akzeptiert das Cmdlet diese Eingabedaten nicht.
Rückgabetypen bzw. Ausgabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets (möglicherweise in englischer Sprache). Wenn das Feld mit dem Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.
| Fehler | Beschreibung |
|---|---|
|
|
|
In diesem Beispiel werden Informationen zu den Benutzern in der Organisationseinheit "Marketing" abgerufen.
Get-User -OrganizationalUnit "Marketing"
In diesem Beispiel wird der Parameter Filter verwendet, um Informationen zu allen Benutzern abzurufen, deren Titel am Ende das Wort "Manager" aufweisen.
Get-User -Filter "Title -like '*Manager'"


Anmerkung: