Get-MailPublicFolder (RTM)
Gilt für: Exchange Server 2007
Letztes Änderungsdatum des Themas: 2007-06-06
Mithilfe des Cmdlets Get-MailPublicFolder können Sie E-Mail-bezogene Informationen über E-Mail-aktivierte Öffentliche Ordner abrufen. Wenn Sie Informationen über die grundlegenden (nicht E-Mail-bezogenen Einstellungen) E-Mail-aktivierter Öffentlicher Ordner abrufen möchten, verwenden Sie das Cmdlet Get-PublicFolder.
Syntax
Get-MailPublicFolder [-Identity <MailPublicFolderIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>] [-SortBy <String>]
Get-MailPublicFolder [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>] [-SortBy <String>]
Get-MailPublicFolder [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>] [-SortBy <String>]
Detaillierte Beschreibung
Damit Sie das Cmdlet Get-MailPublicFolder 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 Exchange Server 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.
Parameter
Parameter | Erforderlich | Typ | Beschreibung |
---|---|---|---|
Anr |
Optional |
System.String |
Mit dem Parameter Anr geben Sie einen Satz von Zeichen als Parameterwerte an, um mit diesen eine ANR-Suche (Ambiguous Name Resolution, Auflösung mehrdeutiger Namen) auszuführen. Der Active Directory-Verzeichnisdienst verwendet den angegebenen Wert und führt die Suche entsprechend der Konfiguration durch. Es werden beispielsweise die folgenden Standardattribute gesucht: der allgemeine Name (Common Name, CN) und der Alias (mailNickname). |
Credential |
Optional |
System.Management.Automation.PSCredential |
Der Parameter Credential gibt das Konto an, das zum Lesen von Active Directory verwendet werden soll. Dies ist besonders nützlich beim Angeben des globalen Katalogs. Das Kennwort sollte auf sichere Weise angefordert werden. |
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
Um den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Domänencontrollers anzugeben, der diese Konfigurationsänderung in Active Directory schreibt, fügen Sie dem Befehl den Parameter DomainController hinzu. |
Filter |
Optional |
System.String |
Der Parameter Filter gibt einen Satz von Attributen an, der zur Erstellung einer Abfrage zum Abrufen einer Reihe von Postfächern verwendet wird. Weitere Informationen zu den filterbaren Eigenschaften finden Sie unter Filterbare Eigenschaften für den Parameter „-Filter“. |
Identity |
Optional |
Microsoft.Exchange.Configuration.Tasks.MailPublicFolderIdParameter |
Verwenden Sie den Parameter Identity, um die GUID oder den Namen des Öffentlichen Ordners anzugeben, die bzw. der einen bestimmten Öffentlichen Ordner darstellt. Sie können den auch den Pfad einschließen, indem Sie das Format Öffentlicher_Ordner_auf_oberster_Ebene\Öffentlicher_Ordner verwenden. Die Bezeichnung des Parameters Identity kann ausgelassen werden, sodass nur der Name des Öffentlichen Ordners oder die GUID angegeben wird. |
OrganizationalUnit |
Optional |
Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter |
Der Parameter OrganizationalUnit gibt eine Organisationseinheit an, auf die die Suche begrenzt werden soll. Die Organisationseinheit oder die Domäne kann angegeben werden. Der kanonische Name der Organisationseinheit sollte angegeben werden. |
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 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 |
Der ResultSize-Parameter gibt die maximale Anzahl zurückzugebender Ergebnisse an. |
SortBy |
Optional |
System.String |
Der Parameter SortBy gibt das Attribut an, anhand dessen die Ergebnisse sortiert werden. Die Sortierung erfolgt attributweise. Das sortierte Resultset wird in aufsteigender Reihenfolge zurückgegeben. |
Server |
Optional |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Der Parameter Server gibt die Identität des Servers an, auf dem der Vorgang ausgeführt werden soll. Wenn kein Server angegeben wird, überprüft der Befehl, ob der lokale Server ein Postfachserver mit Microsoft Exchange 2007 mit einem Informationsspeicher für Öffentliche Ordner ist. Wenn dies der Fall ist, wird der Ordner lokal erstellt. Andernfalls sucht der Befehl den nächsten (bezogen auf die Standortkosten) Exchange 2007-Postfachserver, auf dem ein Informationsspeicher für Öffentliche Ordner bereitgestellt ist. |
Eingabetypen
Rückgabetypen
Fehler
Fehler | Beschreibung |
---|---|
|
Ausnahmen
Ausnahmen | Beschreibung |
---|---|
|
Beispiel
Dieses Beispiel gibt alle E-Mail-aktivierten Öffentlichen Ordner zurück. In diesem Beispiel wird die Ausgabe des Befehls Get-MailPublicFolder über eine Pipeline an den Befehl Format-List übergeben, sodass alle verfügbaren Informationen im Ergebnis angezeigt werden.
Get-MailPublicFolder | Format-List