Freigeben über

Get-Contact (RTM)

  • Artikel

 

Gilt für: Exchange Server 2007

Letztes Änderungsdatum des Themas: 2007-06-05

Mithilfe des Cmdlets Get-Contact können Sie Informationen für einen angegebenen Kontakt oder angegebene Kontakte abrufen.

Syntax

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

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

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

Detaillierte Beschreibung

Das Cmdlet Get-Contact fragt die Eigenschaften eines bestimmten Kontakts oder von Kontaktempfängerobjekten im Active Directory-Verzeichnisdienst ab.

Damit Sie das Cmdlet Get-Contact 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 Anr-Parameter wird für die Suche nach Objekten verwendet, die mit einer angegebenen Teilzeichenfolge übereinstimmen. Er ist ähnlich einer Suche mithilfe von Platzhalterzeichen.

Credential

Optional

System.Management.Automation.PSCredential

Der Credential-Parameter gibt das Konto an, das zum Abfragen von Active Directory auf die Anmeldeinformationen des Kontakts verwendet werden soll.

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 zum Einschränken der von der Abfrage zurückgegebenen Empfänger verwendet werden.

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

Identity

Optional

Microsoft.Exchange.Configuration.Tasks.ContactIdParameter

Der Parameter Identity akzeptiert einen der folgenden Werte:

  • GUID

  • Distinguished Name (DN)

  • Domäne\Konto

  • Benutzerprinzipalname (User Principal Name, UPN)

  • LegacyExchangeDN

  • SMTP-Adresse (Simple Mail Transfer Protocol)

  • Alias

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

  • Contact

  • MailEnabledContact

  • MailEnabledForestContact

ResultSize

Optional

Microsoft.Exchange.Data.Unlimited

Der ResultSize-Parameter gibt die maximale Anzahl zurückzugebender Ergebnisse an.

SortBy

Optional

System.String

Der SortBy-Parameter gibt die Suche nach einem einzelnen Attribut in aufsteigender Reihenfolge an.

Eingabetypen

Rückgabetypen

Fehler

Fehler Beschreibung

 

 

Ausnahmen

Ausnahmen Beschreibung

 

Beispiel

In diesem Beispiel wird mit dem Befehl Get-Contact der Kontakt Ted Bremer abgerufen und das Objekt mittels Pipelining in den Befehl Format-List umgeleitet, um die Informationen zum Kontakt anzuzeigen.

Get-Contact -Identity TedBremer | Format-List