Get-UMMailbox

  • Artikel

 

Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Letztes Änderungsdatum des Themas: 2007-07-20

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>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]

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

Get-UMMailbox [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-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 dem Konto die Rolle Exchange-Empfängeradministrator zugewiesen worden sein.

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.

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 (Ambiguous Name Resolution, ANR) durchgeführt wird. Sie können eine Teilzeichenfolge angeben und nach Objekten mit einem Attribut suchen, das dieser 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

Dieser Parameter gibt den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Domänencontrollers an, der diese Konfigurationsänderung in Active Directory schreibt.

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.

IgnoreDefaultScope

Optional

System.Management.Automation.SwitchParameter

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

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 ihren kanonischen Namen angeben.

ReadFromDomainController

Optional

System.Management.Automation.SwitchParameter

Dieser Parameter gibt an, 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 Server mit Exchange 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