Get-MailContact

 

Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Letztes Änderungsdatum des Themas: 2010-04-27

Mithilfe des Cmdlets Get-MailContact können Sie alle Attribute des angegebenen Kontakts aus Active Directory abrufen.

Syntax

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

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

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

Detaillierte Beschreibung

Dieses Cmdlet ruft alle Attribute des angegebenen Kontakts ab. Es sind keine zusätzlichen Parameter erforderlich. Wenn das Cmdlet ohne einen Parameter ausgeführt wird, wird eine vollständige Liste der Kontakte für die Exchange-Organisation zurückgegeben.

Damit Sie das Cmdlet Get-MailContact 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 angegebene Parameter wird mithilfe der Auflösung mehrdeutiger Namen (Ambiguous Name Resolution, ANR) aufgelöst. Die Standardattribute, die gesucht werden, umfassen:

  • CommonName (CN)

  • DisplayName (displayName)

  • FirstName (givenName)

  • LastName (sn)

  • Alias (mailNickname)

  • LegacyExchangeDN (legacyExchangeDN)

  • Name (name) (statt CommonName/CN)

  • EmailAddresses (proxyAddresses)

  • SamAccountName (samAccountName)

  • Office (physicalDeliveryOfficeName)

Credential

Optional

System.Management.Automation.PSCredential

Dieser Parameter 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 des Domänencontrollers anzugeben, der Daten aus Active Directory abruft, fügen Sie dem Befehl den Parameter DomainController hinzu.

Filter

Optional

System.String

Dieser Parameter 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.MailContactIdParameter

Dieser Parameter identifiziert den Kontakt. Sie können folgende Attribute des Kontakts verwenden: ADObjectID, Distinguished Name, LegacyExchangeDN, GUID, Domäne\SamKontoName, Benutzerprinzipalname (User Principal Name, UPN), E-Mail-Adresse oder Alias.

OrganizationalUnit

Optional

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Dieser Parameter gibt einen Container an, in dem die Ergebnisse begrenzt werden sollen. Es können eine Organisationseinheit (Organizational Unit, OU) oder eine Domäne angegeben werden. Auch der kanonische Name sollte angegeben werden. Beispiel:

  • OU: westcoast.contoso.com/users

  • Domain: westcoast.contoso.com

ReadFromDomainController

Optional

System.Management.Automation.SwitchParameter

Dieser Parameter legt fest, 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 Exchange 2007 werden in Empfängertypen und -untertypen aufgeschlüsselt. 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 dieses Cmdlet lauten:

  • MailEnabledContact

  • MailEnabledForestContact

ResultSize

Optional

Microsoft.Exchange.Data.Unlimited

Dieser Parameter gibt die Gesamtzahl der zurückzugebenden Empfängerobjekte an. Wenn er nicht angegeben wird, gibt der Parameter alle Ergebnisse zurück, die dem Filter entsprechen.

SortBy

Optional

System.String

Dieser Parameter gibt das Attribut an, anhand dessen die Ergebnisse sortiert werden. Die Sortierung erfolgt attributweise und immer in aufsteigender Reihenfolge.

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 DomainController-Parameter 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.

Eingabetypen

Rückgabetypen

Fehler

Fehler Beschreibung

Ausnahmen

Ausnahmen Beschreibung

Beispiel

In diesem Beispiel wird mithilfe des Befehls Get-MailContact der E-Mail-aktivierte Kontakt namens "Ted" abgerufen.

Get-MailContact -Identity Ted | Format-List