Get-CASMailbox

 

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

Letztes Änderungsdatum des Themas: 2011-01-21

Das Cmdlet Get-CASMailbox gibt eine Liste der Attribute eines Microsoft Exchange Server 2007-Postfachs auf einem Computer zurück, auf dem die Serverfunktion ClientAccess installiert ist.

Syntax

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

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

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

Parameter

Parameter Erforderlich Typ Beschreibung

Anr

Optional

System.String

Dieser Parameter akzeptiert einen Satz von Zeichen für die Ausführung einer Suche zur Auflösung eines uneindeutigen Namens. Folgende Attribute gehören zu den durchsuchten:

  • CommonName (CN)

  • DisplayName

  • FirstName

  • LastName

  • Alias

Credential

Optional

System.Management.Automation.PSCredential

Dieser Parameter gibt das Konto an, das zum Lesen aus dem Active Directory-Verzeichnisdienst verwendet werden soll.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

Dieser Parameter gibt den Domänencontroller an, mit dem zur Active Directory-Überprüfung eine Verbindung hergestellt werden soll.

Filter

Optional

System.String

Dieser Parameter gibt einen Satz von Attributen an, der zur Erstellung einer Abfrage zum Abrufen einer Reihe von Postfächern verwendet wird. 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

Dieser Parameter kann die ADObjectID oder eine Zeichenfolge sein, die die GUID, den DN (Distinguished Name), die Domäne/das Konto, den Benutzerprinzipalnamen, den Legacy-Exchange-DN, die SMTP-Adresse oder den Alias darstellt.

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 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 Parameter Credential kann nicht verwendet werden.

OrganizationalUnit

Optional

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Dieser Parameter wird zum Einschränken der Suche auf einen bestimmten Container verwendet.

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

ResultSize

Optional

Microsoft.Exchange.Data.Unlimited

Dieser Parameter gibt die maximale Anzahl zurückzugebender Ergebnisse an. Der Standardwert ist 1000.

SortBy

Optional

System.String

Dieser Parameter gibt das Attribut an, anhand dessen die Ergebnisse sortiert werden. Die Ergebnisse werden in aufsteigender Reihenfolge sortiert.

Detaillierte Beschreibung

Das Cmdlet Get-CASMailbox gibt eine vollständige Liste der Attribute eines Postfachs auf einem Exchange 2007-Clientzugriffsserver zurück. Es wird eine Reihe verschiedener CASMailbox-Attribute zurückgegeben. Zu den Typen der zurückgegebenen Attribute gehören Outlook Web Access, ActiveSync, POP3 und IMAP4.

Standardmäßig werden alle Attribute für alle in der Exchange-Organisation vorhandenen Postfächer zurückgegeben. Diese Ergebnisse können mithilfe der in der Exchange-Verwaltungsshell vorhandenen Funktion gefiltert werden.

Das Cmdlet Get-CASMailbox kann nur auf einem Computer mit Exchange 2007 ausgeführt werden, auf dem die Serverfunktion Mailbox installiert ist. Damit Sie das Cmdlet Get-CASMailbox ausführen können, muss dem Konto die Rolle Exchange-Administrator mit Leserechten zugewiesen worden sein.

Weitere Informationen zu Berechtigungen, zum Delegieren von Rollen und zu den Rechten, die für die Verwaltung von Exchange 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.

Eingabetypen

Rückgabetypen

Fehler

Fehler Beschreibung

 

 

Ausnahmen

Ausnahmen Beschreibung

 

 

Beispiel

Das folgende Codebeispiel gibt alle Details zu Clientzugriffsserver-Postfächern für den Benutzer "Jeff Hay" in der Domäne "Contoso" zurück.

Get-CASMailbox -identity jeffhay@contoso.com