Get-MailUser

 

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-MailUser, um E-Mail-bezogene Attribute des angegebenen Benutzers aus dem Active Directory-Verzeichnisdienst abzurufen.

Syntax

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

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

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

Detaillierte Beschreibung

Das Cmdlet Get-MailUser ruft alle E-Mail-bezogenen Attribute des angegebenen Benutzers ab.

Damit Sie das Cmdlet Get-MailUser 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.

Hinweis

Nicht alle Benutzerattribute werden vom Cmdlet Get-MailUser abgerufen. Sie können zusätzliche Attribute mit dem Cmdlet Get-User abrufen.

Parameter

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 folgenden Standardattribute werden durchsucht:

  • CommonName (CN)

  • DisplayName (displayName)

  • FirstName (givenName)

  • LastName (sn)

  • Alias (mailNickname)

Credential

Optional

System.Management.Automation.PSCredential

Der Parameter Credential gibt das Konto an, das für den Zugriff auf Active Directory verwendet werden soll.

Wenn der Parameter Credential verwendet wird, fordert der Befehl vor dem Fortfahren zur Eingabe des Kontokennworts auf.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

Um den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Domänencontrollers anzugeben, der diese Konfigurationsänderung in Active Directory schreibt, fügen Sie dem Befehl den Parameter DomainController hinzu.

Filter

Optional

System.String

Der Parameter Filter wird zum Filtern der zurückgegebenen Liste der Empfänger verwendet. Sie können die zu filternden Attribute angeben.

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

Identity

Optional

Microsoft.Exchange.Configuration.Tasks.MailUserIdParameter

Der Parameter Identity identifiziert den Benutzer. Sie können die Werte ADObjectID, DN (Distinguished Name), LegacyExchangeDN, GUID, Domäne\SamAccountName, Benutzerprinzipalname (User Principal Name, UPN), E-Mail-Adresse oder Alias des Benutzers verwenden.

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 Parameter OrganizationalUnit gibt einen Container an, in dem die Ergebnisse begrenzt werden sollen. Sie können eine Organisationseinheit oder eine Domäne angeben. Der kanonische Name sollte angegeben werden. Beispiel:

  • OU: westcoast.contoso.com/users

  • Domain: westcoast.contoso.com

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 zurückzugebender Empfängerobjekte an. Erfolgt keine Angabe, gibt der Parameter alle Ergebnisse zurück, die dem Filter entsprechen.

SortBy

Optional

System.String

Der Parameter SortBy gibt das Attribut an, anhand dessen die Ergebnisse sortiert werden. Die Sortierung erfolgt für jeweils ein Attribut gleichzeitig und immer in aufsteigender Reihenfolge.

Eingabetypen

Rückgabetypen

Fehler

Fehler Beschreibung

 

Ausnahmen

Ausnahmen Beschreibung

 

Beispiel

Im ersten Beispiel wird das Cmdlet Get-MailUser ohne Parameter zum Abrufen der vollständigen Liste der E-Mail-aktivierten Benutzer für die gesamte Exchange-Organisation verwendet.

Im zweiten Beispiel werden die E-Mail-Einstellungen für den Benutzer "Ted" abgerufen und dann mittels Pipelining an das Cmdlet Format-List für die Anzeige umgeleitet.

Get-MailUser
Get-MailUser -Identity Ted | Format-List