Get-Contact
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-Contact können Sie Informationen für einen angegebenen Kontakt oder angegebene Kontakte abrufen.
Syntax
Get-Contact [-Identity <ContactIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
Get-Contact [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
Get-Contact [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-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:
|
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:
|
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:
|
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