Get-Recipient

 

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-Recipient können Sie eine Liste der Empfängerobjekte aus dem Active Directory-Verzeichnisdienst zurückgeben.

Syntax

get-Recipient [-Identity <RecipientIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientType <RecipientType[]>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

get-Recipient [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientPreviewFilter <String>] [-RecipientType <RecipientType[]>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

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

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

Detaillierte Beschreibung

Das Cmdlet Get-Recipient ruft Attribute des angegebenen Empfängers ab. Es sind keine zusätzlichen Parameter erforderlich. Wenn das Cmdlet ohne einen Parameter ausgeführt wird, wird eine vollständige Liste der Empfänger für die Organisation zurückgegeben.

Damit Sie das Cmdlet Get-Recipient 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 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 folgende Standardattribute werden durchsucht:

  • CommonName (CN)

  • DisplayName (displayName)

  • FirstName (givenName)

  • LastName (sn)

  • Alias (mailNickname)

Credential

Optional

System.Management.Automation.PSCredential

Der Parameter Credential gibt den zu verwendenden Benutzernamen und das Kennwort für den Zugriff auf Active Directory an.

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

Verwenden Sie den Parameter Filter, um mindestens ein Attribut anzugeben, das die von der Abfrage zurückgegebenen Empfänger einschränkt. Dieser Parameter kann nicht zusammen mit dem Identity-Parameter oder dem Anr-Parameter verwendet werden.

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

Identity

Optional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

Der Parameter Identity identifiziert den Empfänger. Einer der folgenden Werte kann verwendet werden:

  • GUID

  • Domäne\Konto

  • Benutzerprinzipalname (User Principal Name, UPN)

  • LegacyExchangeDN

  • SMTP-Adresse (Simple Mail Transfer Protocol)

  • Name

  • Alias

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 den kanonischen Namen einer Organisationseinheit oder einer Domäne an und wird zum Beschränken der Ergebnisse verwendet. Wenn Sie diesen Parameter verwenden, werden nur Empfänger aus dem von Ihnen angegebenen Container abgerufen. 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.

RecipientPreviewFilter

Optional

System.String

Verwenden Sie den Parameter RecipientPreviewFilter, um einen Empfängerfilter anzugeben, der die von diesem Befehl zurückgegebenen Empgänger definoert. Sie können einen benutzerdefinierten Empfängerfilter für eine dynamische Verteilergruppe, eine Adressliste oder eine E-Mail-Adressenrichtlinie erstellen. Wenn Sie überprüfen möchten, ob der von Ihnen angegebene Empfängerfilter die gewünschten Empfänger zurückgibt, können Sie den in der Eigenschaft RecipientFilter für diese dynamische Verteilergruppe, Adressliste oder E-Mail-Adressenrichtlinie angegebenen OPATH-Filter an den Parameter RecipientPreviewFilter übergeben und eine Vorschau der Liste der Empfänger anzeigen.

RecipientType

Optional

Microsoft.Exchange.Data.Directory.Recipient.RecipientType[]

Der Parameter RecipientType legt den Typ der Empfänger fest, die zurückgegeben werden sollen. Einer oder mehrere der folgenden Typen können verwendet werden:

  • UserMailbox

  • MailUser

  • MailContact

  • MailUniversalDistributionGroup

  • MailUniversalSecurityGroup

  • MailNonUniversalGroup

  • DynamicDistributionGroup

  • PublicFolder

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:

  • ConferenceRoomMailbox

  • EquipmentMailbox

  • LegacyMailbox

  • LinkedMailbox

  • UserMailbox

  • MailContact

  • DynamicDistributionGroup

  • MailForestContact

  • MailNonUniversalGroup

  • MailUniversalDistributionGroup

  • MailUniversalSecurityGroup

  • MailUser

  • PublicFolder

  • SharedMailbox

ResultSize

Optional

Microsoft.Exchange.Data.Unlimited

Der ResultSize-Parameter gibt die maximale Anzahl zurückzugebender Ergebnisse an. Wenn Sie alle Empfänger zurückgeben möchten, die dem Filter entsprechen, verwenden Sie "unlimited" als Wert für diesen Parameter. Der Standardwert ist 1000.

SortBy

Optional

System.String

Der Parameter SortBy gibt das Attribut an, anhand dessen die Ergebnisse sortiert werden. Sie können jeweils nur nach einem Attribut sortieren. Nach den folgende Attributen kann sortiert werden:

  • Alias

  • DisplayName

  • Name

Die Ergebnisse werden in aufsteigender Reihenfolge sortiert.

Eingabetypen

Rückgabetypen

Fehler

Fehler Beschreibung

   

 

Ausnahmen

Ausnahmen Beschreibung

  

 

Beispiel

Das erste Beispiel zeigt, wie Informationen zu allen Empfängern in Ihrer Organisation abgerufen werden.

Das zweite Beispiel zeigt, wie Informationen zu allen E-Mail-aktivierten Kontakten in Ihrer Organisation abgerufen und nach Namen sortiert werden.

Get-Recipient -ResultSize unlimited
Get-Recipient -RecipientType MailContact -SortBy Name