Exchange
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

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:

  • CommonName (CN)
  • DisplayName
  • FirstName
  • LastName
  • Alias

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:

  • Alias
    Beispiel: JPhilips
  • Canonical DN
    Beispiel: Atlanta.Corp.Contoso.Com/Users/JPhilips
  • Display Name
    Beispiel: Jeff Philips
  • Distinguished Name (DN)
    Beispiel: CN=JPhilips,CN=Users,DC=Atlanta,DC=Corp,DC=contoso,DC=com
  • Domain\Account
    Beispiel: Atlanta\JPhilips
  • GUID
    Beispiel: fb456636-fe7d-4d58-9d15-5af57d0354c2
  • Immutable ID
    Beispiel: fb456636-fe7d-4d58-9d15-5af57d0354c2@contoso.com
  • Legacy Exchange DN
    Beispiel: /o=Contoso/ou=AdministrativeGroup/cn=Recipients/cn=JPhilips
  • SMTP Address
    Beispiel: Jeff.Philips@contoso.com
  • User Principal Name
    Beispiel: JPhilips@contoso.com

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:

  • Sie können den Parameter DomainController nicht verwenden. Der Befehl verwendet automatisch einen geeigneten globalen Katalogserver.
  • Für den Parameter Identity kann nur der DN verwendet werden. Andere Formen der Identifikation wie Aliasnamen oder GUIDs werden nicht akzeptiert.
  • Sie können die Parameter OrganizationalUnit und Identity nicht zusammen verwenden.
  • Sie können den Parameter Credential nicht verwenden.

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.

Aa996896.note(de-DE,EXCHG.141).gifAnmerkung:
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:

  • DiscoveryMailbox
  • EquipmentMailbox
  • LegacyMailbox
  • LinkedMailbox
  • MailUser
  • RoomMailbox
  • SharedMailbox
  • SystemAttendantMailbox
  • SystemMailbox
  • User

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

 

 

Ausnahmen 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'"
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
Microsoft führt eine Onlineumfrage durch, um Ihre Meinung zur MSDN-Website zu erfahren. Wenn Sie sich zur Teilnahme entscheiden, wird Ihnen die Onlineumfrage angezeigt, sobald Sie die MSDN-Website verlassen.

Möchten Sie an der Umfrage teilnehmen?