Get-Mailbox

  • Artikel

 

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-Mailbox können Sie die Postfachobjekte und -attribute anzeigen, Eigenschaftenseiten auffüllen oder Postfachinformationen an andere Tasks übergeben.

Syntax

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

get-Mailbox [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>] [-SortBy <String>]

get-Mailbox [-Credential <PSCredential>] [-Database <DatabaseIdParameter>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

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

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

Detaillierte Beschreibung

Das Cmdlet Get-Mailbox ruft Attribute und Objekte eines Postfachs ab. Es sind keine zusätzlichen Parameter erforderlich. Wenn Sie das Cmdlet ohne Parameter verwenden, werden alle Postfächer in der Organisation aufgelistet.

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

Hinweis

Um den aktuellen Status des Speicherkontingents mit dem Cmdlet Get-Mailbox genau zu untersuchen, muss neben den Eigenschaften ProhibitSendQuota, ProhibitSendReceiveQuota und IssueWarningQuota auch die Eigenschaft UseDatabaseQuotaDefault überprüft werden. Der Wert True für die Eigenschaft UseDatabaseQuotaDefaults bedeutet, das postfachspezifische Einstellungen ignoriert und die Grenzwerte für Postfachdatenbanken verwendet werden. Wenn diese Eigenschaft auf True gesetzt wird und die Eigenschaften ProhibitSendQuota, ProhibitSendReceiveQuota und IssueWarningQuota auf Unbegrenzt festgelegt werden, ist die Größe des Postfachs nicht unbegrenzt. Stattdessen müssen Sie die Speichergrenzwerte des Postfachdatenbank referenzieren, um zu ermitteln, welche Grenzwerte für das Postfach vorhanden sind. Der Wert False für die Eigenschaft UseDatabaseQuotaDefaults bedeutet, dass die postfachspezifischen Einstellungen verwendet werden.

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 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

  • FirstName

  • LastName

  • Alias

Credential

Optional

System.Management.Automation.PSCredential

Der ParameterCredential gibt den zu verwendenden Benutzernamen und das Kennwort für den Zugriff auf den Active Directory-Verzeichnisdienst an.

Database

Optional

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

Der Parameter Database gibt die Datenbank an, aus der das Postfach abgerufen werden soll. Folgende Werte können verwendet werden:

  • GUID der Datenbank

  • Datenbankname

  • Servername\Datenbankname

  • Servername\Speichergruppe\Datenbankname

Wenn Sie den Servernamen nicht angeben, sucht das Cmdlet auf dem lokalen Server nach der Datenbank. Wenn Sie über mehrere Datenbanken mit gleichem Namen auf dem gleichen Server verfügen, müssen Sie die Speichergruppe angeben.

Dieser Parameter kann nicht gemeinsam mit dem Parameter Filter verwendet werden.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

Der Parameter DomainController gibt den Domänencontroller an, der für den Zugriff auf Active Directory verwendet werden soll. Verwenden Sie den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Domänencontrollers, der verwendet werden soll.

Filter

Optional

System.String

Mit dem Parameter Filter können Sie ein oder mehrere Attribute angeben, um die von der Abfrage zurückgegebenen Postfächer einzuschränken.

Dieser Parameter kann nicht gemeinsam mit dem Parameter Database verwendet werden.

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

Identity

Optional

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Der Parameter Identity identifiziert das Postfach. Einer der folgenden Werte kann verwendet werden:

  • GUID

  • Distinguished Name (DN)

  • Domäne\Konto

  • Benutzerprinzipalname (User Principal Name, UPN)

  • LegacyExchangeDN

  • SmtpAddress

  • Alias

IgnoreDefaultScope

Optional

System.Management.Automation.SwitchParameter

Mit dem IgnoreDefaultScope-Parameter 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 IgnoreDefaultScope-Parameters 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 Identity-Parameter 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 Credential-Parameter kann nicht verwendet werden.

OrganizationalUnit

Optional

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Der Parameter OrganizationalUnit gibt eine Organisationseinheit an und wird zum Beschränken der Ergebnisse verwendet. Wenn Sie diesen Parameter verwenden, werden nur Postfächer aus dem von Ihnen angegebenen Container abgerufen. Sie können entweder den Namen der Organisationseinheit oder der Domäne verwenden. Wenn Sie die Organisationseinheit verwenden, müssen Sie deren kanonischen Namen angeben.

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 unter Umständen 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 RoomMailbox festgelegt, während bei einem Benutzerpostfach RecipientTypeDetails auf UserMailbox festgelegt ist.

Die verfügbaren Empfängertypdetails für diesen Befehl lauten:

  • RoomMailbox

  • EquipmentMailbox

  • LegacyMailbox

  • LinkedMailbox

  • UserMailbox

  • SharedMailbox

ResultSize

Optional

Microsoft.Exchange.Data.Unlimited

Der Parameter ResultSize gibt die maximale Anzahl zurückzugebender Ergebnisse an. Wenn Sie alle Postfächer zurückgeben möchten, die der Abfrage entsprechen, verwenden Sie "unlimited" als Wert für diesen Parameter. Der Standardwert ist 1000.

Server

Optional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Der Parameter Server gibt einen bestimmten Server an und wird zum Beschränken der Ergebnisse verwendet. Wenn Sie diesen Parameter verwenden, werden nur Postfächer abgerufen, die sich auf dem von Ihnen angegebenen Server befinden. Verwenden Sie den allgemeinen Namen des gewünschten Servers.

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

  • Anzeigename

  • Name

Die Ergebnisse werden in aufsteigender Reihenfolge sortiert.

Eingabetypen

Rückgabetypen

Fehler

Fehler Beschreibung

 

Ausnahmen

Ausnahmen Beschreibung

 

Beispiel

Das erste Beispiel zeigt, wie eine Liste aller Postfächer in Ihrer Organisation abgerufen wird.

Das zweite Beispiel zeigt, wie eine Liste aller Postfächer in Ihrer Organisation abgerufen wird, die sich im Benutzercontainer der Domäne "Contoso.com" befinden.

Das dritte Beispiel zeigt, wie Sie alle Postfächer abrufen, die sich aus der Suche zur Auflösung eines mehrdeutigen Namens für die Zeichenfolge "Chr" ergeben, die sich in der Domäne "DC01" befinden. Zurückgegeben werden die Postfächer von Benutzern wie "Chris Ashton", "Christian Cletus" und "Christa Geller".

Get-Mailbox -ResultSize unlimited
Get-Mailbox -OrganizationalUnit Users
Get-Mailbox -Anr Chr -DomainController DC01