(0) exportieren Drucken
Alle erweitern

Get-Mailbox

 

Gilt für: Exchange Server 2013, Exchange Online

Letztes Änderungsdatum des Themas: 2014-07-08

Dieses Cmdlet ist lokal Exchange Server 2013 und im Cloud-basierten Dienst verfügbar. Einige Parameter und Einstellungen gelten exklusiv für die eine oder andere Umgebung.

Mithilfe des Cmdlets Get-Mailbox können Sie die Postfachobjekte und -attribute anzeigen, Eigenschaftenseiten auffüllen oder Postfachinformationen an andere Tasks übergeben.

Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax.

Get-Mailbox [-Identity <MailboxIdParameter>] <COMMON PARAMETERS>
Get-Mailbox [-MailboxPlan <MailboxPlanIdParameter>] <COMMON PARAMETERS>
Get-Mailbox [-Server <ServerIdParameter>] <COMMON PARAMETERS>
Get-Mailbox [-Database <DatabaseIdParameter>] <COMMON PARAMETERS>
Get-Mailbox [-Anr <String>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-AccountPartition <AccountPartitionIdParameter>] [-Arbitration <SwitchParameter>] [-Archive <SwitchParameter>] [-AuxMailbox <SwitchParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-InactiveMailboxOnly <SwitchParameter>] [-IncludeInactiveMailbox <SwitchParameter>] [-IncludeSoftDeletedMailbox <SwitchParameter>] [-Monitoring <SwitchParameter>] [-Organization <OrganizationIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-PublicFolder <SwitchParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-RemoteArchive <SwitchParameter>] [-ResultSize <Unlimited>] [-SoftDeletedMailbox <SwitchParameter>] [-SortBy <String>] [-UsnForReconciliationSearch <Int64>]

In diesem Beispiel wird eine Liste aller Postfächer in Ihrer Organisation zurückgegeben.

Get-Mailbox -ResultSize unlimited

In diesem Beispiel wird eine Liste aller Postfächer in Ihrer Organisation in der Organisationseinheit des Benutzers zurückgegeben.

Get-Mailbox -OrganizationalUnit Users

In diesem Beispiel werden alle Postfächer zurückgegeben, 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. In diesem Beispiel werden die Postfächer für Benutzer wie "Chris Ashton", "Christian Hess" und "Christa Geller" zurückgegeben.

Get-Mailbox -Anr Chr -DomainController DC01

In diesem Beispiel werden Informationen zum Postfach mit dem Namen "Chris" zurückgegeben, darunter auch Informationen zum Archivpostfach.

Get-Mailbox -Identity Chris -Archive

In diesem Beispiel werden Informationen zum Postfach "ed@contoso.com" zurückgegeben, einschließlich Informationen zum Remotearchivpostfach dieses Benutzers.

Get-Mailbox -Identity ed@contoso.com -RemoteArchive

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.

HinweisAnmerkung:
Für die genaue Evaluierung des aktuellen Speicherkontingentstatus mithilfe des Cmdlets Get-Mailbox muss neben den Eigenschaften ProhibitSendQuota, ProhibitSendReceiveQuota und IssueWarningQuota auch die Eigenschaft UseDatabaseQuotaDefaults ü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.

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. In diesem Thema sind zwar alle Parameter für das Cmdlet aufgeführt, aber Sie verfügen möglicherweise nicht über Zugriff auf einige Parameter, falls diese nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Informationen zu den von Ihnen benötigten Berechtigungen finden Sie unter "Berechtigungen für die Empfängerbereitstellung" im Thema Empfängerberechtigungen.

 

Parameter Erforderlich Typ Beschreibung

AccountPartition

Optional

Microsoft.Exchange.Configuration.Tasks.AccountPartitionIdParameter

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

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 gesuchten Standardattribute umfassen:

  • CommonName (CN)

  • DisplayName

  • FirstName

  • LastName

  • Alias

Arbitration

Optional

System.Management.Automation.SwitchParameter

Dieser Parameter ist im lokalen Exchange verfügbarExchange 2013.

Der Parameter Arbitration gibt an, dass es sich bei dem Postfach, für das Sie den Befehl ausführen, um ein Vermittlungspostfach handelt. Vermittlungspostfächer werden zum Verwalten des Genehmigungsworkflows verwendet. Ein Vermittlungspostfach wird z. B. für die Verarbeitung moderierter Empfänger und für die Genehmigung von Verteilergruppenmitgliedschaften verwendet.

Archive

Optional

System.Management.Automation.SwitchParameter

Der Parameter Archive gibt an, ob Informationen zum Archivpostfach des Empfängers zurückgegeben werden.

AuxMailbox

Optional

System.Management.Automation.SwitchParameter

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

Credential

Optional

System.Management.Automation.PSCredential

Dieser Parameter ist im lokalen Exchange verfügbarExchange 2013.

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

Dieser Parameter erfordert die Erstellung und Übergabe eines Anmeldeinformationsobjekts. Dieses Anmeldeinformationsobjekt wird mithilfe des Cmdlets Get-Credential erstellt. Weitere Informationen finden Sie unter Get-Credential.

Database

Optional

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

Dieser Parameter ist im lokalen Exchange verfügbarExchange 2013.

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

  • GUID der Datenbank

  • Datenbankname

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

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

Dieser Parameter ist im lokalen Exchange verfügbarExchange 2013.

Der Parameter DomainController gibt den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Domänencontrollers an, der Daten aus Active Directory abruft.

Filter

Optional

System.String

Der Parameter Filter gibt den OPath-Filter an, der zum Filtern von Empfängern verwendet wird.

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 gibt die Identität des Postfachs an. Einer der folgenden Werte kann verwendet werden:

  • GUID

  • Distinguished Name (DN)

  • Anzeigename

  • Domäne\Konto

  • Benutzerprinzipalname (User Principal Name, UPN)

  • LegacyExchangeDN

  • SmtpAddress

  • Alias

IgnoreDefaultScope

Optional

System.Management.Automation.SwitchParameter

Dieser Parameter ist im lokalen Exchange verfügbarExchange 2013.

Der Parameter IgnoreDefaultScope weist den Befehl an, die Standardeinstellung für den Empfängerbereich für die Exchange-Verwaltungsshell-Sitzung zu ignorieren und die vollständige 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:

  • Sie können den Parameter DomainController nicht verwenden. Der Befehl verwendet automatisch einen geeigneten globalen Katalogserver.

  • Für den Parameter Identity kann nur der DN verwendet werden. Andere Formen der Identifikation wie Aliasnamen oder GUIDs werden nicht akzeptiert.

  • Sie können die Parameter OrganizationalUnit und Identity nicht zusammen verwenden.

  • Sie können den Parameter Credential nicht verwenden.

InactiveMailboxOnly

Optional

System.Management.Automation.SwitchParameter

Diese Parameter ist nur im cloudbasierten Dienst verfügbar.

Der Parameter InactiveMailboxOnly gibt den Befehl an, um nur inaktive Postfächer zurückzugeben. Ein inaktives Postfach ist ein Postfach, das entfernt oder nicht dauerhaft gelöscht wurde. Inaktive Postfächer können bis zu 30 Tage, nachdem sie entfernt wurden, wiederhergestellt werden.

Diese Parameter ist nur im cloudbasierten Dienst verfügbar.

IncludeInactiveMailbox

Optional

System.Management.Automation.SwitchParameter

Diese Parameter ist nur im cloudbasierten Dienst verfügbar.

Der Parameter IncludeInactiveMailbox gibt den Befehl an, um sowohl aktive als auch inaktive Postfächer zurückzugeben. Ein inaktives Postfach ist ein Postfach, das entfernt oder nicht dauerhaft gelöscht wurde. Inaktive Postfächer können bis zu 30 Tage, nachdem sie entfernt wurden, wiederhergestellt werden.

Diese Parameter ist nur im cloudbasierten Dienst verfügbar.

IncludeSoftDeletedMailbox

Optional

System.Management.Automation.SwitchParameter

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

MailboxPlan

Optional

Microsoft.Exchange.Configuration.Tasks.MailboxPlanIdParameter

Diese Parameter ist nur im cloudbasierten Dienst verfügbar.

Der Parameter MailboxPlan gibt den Befehl zum Zurückgeben von diesen Postfacheinstellungen zugeordneten Postfächern an. In den Postfacheinstellungen werden die Berechtigungen und verfügbaren Funktionen für einen Postfachbenutzer angegeben. Der angegebene Name der Postfacheinstellungen muss in den Diensteinstellungen der Organisation enthalten sein, zu der das Postfach gehört.

Monitoring

Optional

System.Management.Automation.SwitchParameter

Dieser Parameter ist im lokalen Exchange verfügbarExchange 2013.

Der Parameter Monitoring gibt eine Liste von Postfächern an, die den Wert MonitoringMailbox für die Eigenschaft RecipientTypeDetails aufweisen. Es werden automatisch zwei Überwachungspostfächer für jede Postfachdatenbank in Ihrer Organisation erstellt: Ein Postfach zum Überwachen der Integrität von Öffentlichen Ordnern und ein Postfach zum Überwachen der Integrität von Standortpostfächern.

Organization

Optional

Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter

Der Parameter Organization ist für die interne Verwendung durch Microsoft reserviert.

OrganizationalUnit

Optional

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Der Parameter OrganizationalUnit gibt eine Organisationseinheit an und wird zum Begrenzen 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.

PublicFolder

Optional

System.Management.Automation.SwitchParameter

Der Parameter PublicFolder gibt an, dass das Postfach ein Postfach für Öffentliche Ordner ist. Postfächer für öffentliche Ordner wurden eigens entworfen, um die Hierarchie und Inhalte von öffentlichen Ordnern zu speichern. Dieser Parameter ist erforderlich, um Informationen zu einem Postfach für Öffentliche Ordner anzuzeigen.

ReadFromDomainController

Optional

System.Management.Automation.SwitchParameter

Dieser Parameter ist im lokalen Exchange verfügbarExchange 2013.

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.

HinweisAnmerkung:
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 gibt den Typ der Empfänger an, die zurückgegeben werden sollen. Empfängertypen 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 durch den Parameter RecipientTypeDetails identifiziert. Bei einem Konferenzraum-Postfach ist beispielsweise RecipientTypeDetails auf RoomMailbox festgelegt, während bei einem Benutzerpostfach RecipientTypeDetails auf UserMailbox festgelegt ist.

Dieser Parameter akzeptiert die folgenden Werte:

  • RoomMailbox

  • EquipmentMailbox

  • LegacyMailbox

  • LinkedMailbox

  • UserMailbox

  • DiscoveryMailbox

  • SharedMailbox

RemoteArchive

Optional

System.Management.Automation.SwitchParameter

Dieser Parameter ist im lokalen Exchange verfügbarExchange 2013.

Der Parameter RemoteArchive gibt an, ob das Remotearchiv für dieses Postfach getrennt werden soll. Ein Remotearchiv ist in einem cloudbasierten Dienst vorhanden.

Bei Verwendung dieses Parameters können Sie den Parameter Archive nicht verwenden.

ResultSize

Optional

Microsoft.Exchange.Data.Unlimited

Der ResultSize-Parameter 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 lautet 1000.

Server

Optional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Dieser Parameter ist im lokalen Exchange verfügbarExchange 2013.

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.

SoftDeletedMailbox

Optional

System.Management.Automation.SwitchParameter

Diese Parameter ist nur im cloudbasierten Dienst verfügbar.

Der Parameter SoftDeletedMailbox gibt eine Liste von gelöschten Postfächern an, die innerhalb der letzten 30 Tage gelöscht wurden.

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.

UsnForReconciliationSearch

Optional

System.Int64

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

Eingabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Eingabetyp für ein Cmdlet leer ist, akzeptiert das Cmdlet diese Eingabedaten nicht.

Rückgabetypen bzw. Ausgabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.

 
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
Vielen Dank für Ihr Feedback.
Anzeigen:
© 2014 Microsoft