Get-PublicFolder (RTM)
Gilt für: Exchange Server 2007
Letztes Änderungsdatum des Themas: 2007-06-06
Verwenden Sie das Cmdlet Get-PublicFolder, um die Attribute eines oder mehrerer Öffentlicher Ordner abzurufen.
Syntax
Get-PublicFolder [-Identity <PublicFolderIdParameter>] [-DomainController <Fqdn>] [-Server <ServerIdParameter>]
Get-PublicFolder [-Identity <PublicFolderIdParameter>] -GetChildren <SwitchParameter> [-DomainController <Fqdn>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>]
Get-PublicFolder [-Identity <PublicFolderIdParameter>] -Recurse <SwitchParameter> [-DomainController <Fqdn>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>]
Detaillierte Beschreibung
Damit Sie das Cmdlet Get-PublicFolder 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 |
|---|---|---|---|
GetChildren |
Erforderlich |
System.Management.Automation.SwitchParameter |
Verwenden Sie den Parameter GetChildren, um nur die untergeordneten Elemente des Ordners abzurufen, der über den Parameter Identity angegeben wird. Der Parameter GetChildren und der Parameter Recurse schließen sich gegenseitig aus. |
Recurse |
Erforderlich |
System.Management.Automation.SwitchParameter |
Mit dem Parameter Recurse wird angegeben, dass der Befehl den angegebenen Öffentlichen Ordner und dessen untergeordnete Elemente zurückgeben muss. |
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
Um den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Domänencontrollers anzugeben, der Daten aus dem Active Directory-Verzeichnisdienst abruft, fügen Sie dem Befehl den Parameter DomainController hinzu. |
Identity |
Optional |
Microsoft.Exchange.Configuration.Tasks.PublicFolderIdParameter |
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. |
ResultSize |
Optional |
Microsoft.Exchange.Data.Unlimited |
Der ResultSize-Parameter gibt die maximale Anzahl zurückzugebender Ergebnisse an. Der Standardmaximalwert ist 10.000. Um die Anzahl der zurückgegebenen Ergebnisse nicht zu begrenzen, setzen Sie diesen Parameter auf Unlimited. Dieser Parameter kann nur in Kombination mit dem Parameter Recurse oder dem Parameter GetChildren übergeben werden. |
Server |
Optional |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Der Parameter Server gibt den Server an, auf dem die ausgewählten Vorgänge ausgeführt werden sollen. |
Eingabetypen
Rückgabetypen
Fehler
| Fehler | Beschreibung |
|---|---|
|
Ausnahmen
| Ausnahmen | Beschreibung |
|---|---|
|
Beispiel
Die folgenden Codebeispiele illustrieren die Verwendung des Befehls Get-PublicFolder.
Das erste Beispiel verwendet den Befehl Get-PublicFolder ohne Parameter, um das Objekt des Öffentlichen Stammordners (IPM_SUBTREE) zurückzugeben.
Das zweite Beispiel gibt die Namen aller Systemordner zurück (die standardmäßig nicht angezeigt werden), beginnend mit dem Systemordnerstamm (\NON_IPM_SUBTREE).
Das dritte Beispiel gibt den Öffentlichen Ordner mit der angegebenen ausgeschriebenen Eintrags-ID zurück.
Das vierte Beispiel gibt den Öffentlichen Ordner Schwebende Verfahren unter \Gerichtsverfahren\Dokumente\ zurück.
Das fünfte Beispiel gibt den Öffentlichen Ordner Schwebende Verfahren unter \Gerichtsverfahren\Dokumente\ sowie bis zu 9.999 Öffentliche Ordner unterhalb des Öffentlichen Ordners Schwebende Verfahren zurück.
Das sechste Beispiel gibt den Öffentlichen Ordner Schwebende Verfahren unter \Gerichtsverfahren\Dokumente\ sowie alle Öffentlichen Ordner unterhalb dieses Ordners ohne Begrenzung der Anzahl der zurückgegebenen Ergebnisse zurück.
Get-PublicFolder
Get-PublicFolder -Identity \NON_IPM_SUBTREE -Recurse | Format-List Name
Get-PublicFolder -Identity <long-term entry identifier of a public folder>
Get-PublicFolder -Identity "\Legal\Documents\Pending Litigation"
Get-PublicFolder -Identity "\Legal\Documents\Pending Litigation" -Recurse
Get-PublicFolder -Identity "\Legal\Documents\Pending Litigation" -Recurse -ResultSize Unlimited