Get-UMMailbox (RTM)

  • Artikel

 

Gilt für: Exchange Server 2007

Letztes Änderungsdatum des Themas: 2007-06-11

Das Cmdlet Get-UMMailbox zeigt die Unified Messaging-Eigenschaften (UM) für einen UM-aktivierten Benutzer an.

Syntax

Get-UMMailbox [-Identity <MailboxIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]

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

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

Detaillierte Beschreibung

Mit dem Cmdlet Get-UMMailbox können Sie die Eigenschaften für ein einzelnes UM-Postfach abrufen. Es kann auch eine Liste der UM-aktivierten Postfächer zurückgeben.

Damit Sie das Cmdlet Get-UMMailbox ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:

  • die Rolle Exchange-Empfängeradministrator

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

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

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

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

Um den vollqualifizierten Domänennamen des Domänencontrollers anzugeben, der diese Konfigurationsänderung in den Active Directory-Verzeichnisdienst schreibt, fügen Sie dem Cmdlet den Parameter DomainController hinzu.

Filter

Optional

System.String

Mit diesem Parameter können Sie die vom Cmdlet zurückgegebenen Ergebnisse filtern.

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

Identity

Optional

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Dieser Parameter gibt den für Unified Messaging zu aktivierenden Benutzer an. Zu den Variablen für diesen Parameter gehören die folgenden:

  • ADObjectID

  • GUID

  • DN

  • Domäne\Konto

  • UPN

  • LegacyExchangeDN

  • SmtpAddress

  • Alias

Dieser Parameter ist erforderlich, wenn der Parameter Instance nicht verwendet wird.

OrganizationalUnit

Optional

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Dieser Parameter 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.

ReadFromDomainController

Optional

System.Management.Automation.SwitchParameter

Dieser Parameter legt fest, dass die Benutzerinformationen von einem Domänencontroller in der Domäne des Benutzers abgerufen werden. Wenn Sie festgelegt haben, 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 abgerufen. Wenn Sie diesen Parameter verwenden, sind zum Abrufen der Informationen möglicherweise mehrere Lesevorgänge erforderlich. Standardmäßig ist der Empfängerbereich auf die Domäne festgelegt, in der sich Ihre Exchange-Server befinden.

ResultSize

Optional

Microsoft.Exchange.Data.Unlimited

Dieser Parameter gibt die maximale Anzahl von Ergebnissen an, die zurückgegeben werden. Andernfalls ist kein Höchstwert festgelegt, und das das Cmdlet gibt alle Ergebnisse zurück.

SortBy

Optional

System.String

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

Typ Beschreibung

 

 

Rückgabetypen

Typ Beschreibung

 

 

Fehler

Fehler Beschreibung

 

 

Beispiel

Das erste Codebeispiel zeigt eine formatierte Liste aller UM-aktivierten Postfächer in der Active Directory-Gesamtstruktur an.

Das zweite Codebeispiel zeigt die UM-Postfacheigenschaften für yanli@contoso.com an.

Get-UMMailbox | format-list

Get-UMMailbox -Identity yanli@contoso.com