Freigeben über

Get-PublicFolder

  • Artikel

 

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

Letztes Änderungsdatum des Themas: 2009-05-12

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>] -Recurse <SwitchParameter> [-DomainController <Fqdn>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>]

Get-PublicFolder [-Identity <PublicFolderIdParameter>] -GetChildren <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:

  • Die Rolle Exchange-Öffentliche Ordner-Administrator und die Mitgliedschaft in der lokalen Gruppe Administratoren für den Zielserver

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

Wenn Sie das Cmdlet Get-PublicFolder ausführen, und der Wert von UseDatabaseQuotaDefaults ist true, werden die folgenden Werte mit den Datenbankwerten von Get-PublicFolderDatabase abgerufen:

  • MaxItemSize

  • IssueWarningQuota

  • ProhibitPostQuota

Außerdem wird an jeden Wert die Zeichenfolge "(InheritFromDB)" angehängt.