Get-SiteMailbox

  • Referenz
Modul:
ExchangePowerShell
Gilt für::
Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Dieses Cmdlet ist nur lokal in Exchange verfügbar.

Verwenden Sie das Cmdlet Get-SiteMailbox, um Informationen zu Websitepostfächern anzuzeigen. Dieses Cmdlet wird hauptsächlich von Microsoft SharePoint und Exchange zum Anzeigen von Informationen für Benutzer in der Benutzeroberfläche verwendet. Es ist jedoch auch nützlich, um Informationen wie z. B. Besitzer, Mitglieder und Lebenszyklusstatus eines Websitepostfachs zu ermitteln.

Websitepostfächer waren 2017 in Exchange Online und SharePoint Online veraltet. Weitere Informationen finden Sie unter Veraltetkeit von Websitepostfächern.

Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.

Syntax

Get-SiteMailbox
   [[-Identity] <RecipientIdParameter>]
   [-Anr <String>]
   [-BypassOwnerCheck]
   [-DeletedSiteMailbox]
   [-DomainController <Fqdn>]
   [-ReadFromDomainController]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]

Beschreibung

Wenn Sie kein Mitglied oder nicht der Besitzer des Websitepostfachs sind, für das Diagnoseinformationen angezeigt werden sollen, müssen Sie beim Ausführen dieses Cmdlets den Parameter BypassOwnerCheck verwenden. Wenn Sie kein Mitglied oder nicht der Besitzer des Websitepostfachs sind und Sie dieses Cmdlet ohne den Parameter BypassOwnerCheck ausführen, tritt für den Befehl der Fehler "Objekt nicht gefunden" auf.

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Auch wenn in diesem Thema alle Parameter für das Cmdlet aufgeführt werden, verfügen Sie möglicherweise nicht über den Zugriff auf einige Parameter, wenn sie nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Wie Sie herausfinden, welche Berechtigungen zur Ausführung eines bestimmten Cmdlets oder Parameters in Ihrer Organisation erforderlich sind, können Sie unter Find the permissions required to run any Exchange cmdlet nachlesen.

Beispiele

Beispiel 1

Get-SiteMailbox -BypassOwnerCheck -Identity ContentSite

In diesem Beispiel werden die Standardinformationen zum Websitepostfach ContentSite zurückgegeben, einschließlich des Websitenamens, des Zeitpunkts des Schließens des Websitepostfachs und der SharePoint-URL.

Beispiel 2

Get-SiteMailbox -BypassOwnerCheck -Identity ContentSite | Format-List

In diesem Beispiel werden die vollständigen Informationen über das Websitepostfach "ContentSite" zurückgegeben.

Beispiel 3

Get-SiteMailbox -BypassOwnerCheck -DeletedSiteMailbox | Remove-Mailbox -Confirm:$false

In diesem Beispiel werden Standortpostfächer abgefragt, die zum Löschen markiert sind, und aus durch Pipelining des CmdletRemove-Mailbox aus der Postfachdatenbank entfernt.

Parameter

-Anr

Der Parameter Anr 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 der Zeichenfolge entspricht. Die gesuchten Standardattribute umfassen:

  • CommonName (CN)
  • DisplayName
  • FirstName
  • LastName
  • Alias
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-BypassOwnerCheck

Der BypassOwnerCheck-Parameter wird verwendet, wenn das Konto, das den Befehl ausführt, kein Mitglied oder Besitzer des Websitepostfachs ist. Sie müssen bei dieser Option keinen Wert angeben.

Wenn Sie diesen Schalter nicht verwenden und kein Mitglied oder Besitzer des Websitepostfachs sind, schlägt der Befehl fehl.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DeletedSiteMailbox

Mit der Option DeletedSiteMailbox werden Websitepostfächer zurückgegeben, die zum Löschen markiert wurden. Sie müssen bei dieser Option keinen Wert angeben.

Wenn die Lebenszyklusanwendung in SharePoint ein Websitepostfach schließt, wird das Websitepostfach für den in der Lebenszyklusrichtlinie angegebenen Zeitraum im geschlossenen Zustand beibehalten. Das Postfach kann dann von einem Endbenutzer oder einem SharePoint-Administrator reaktiviert werden. Nach dem Aufbewahrungszeitraum wird dem Exchange-Standortpostfach, das in der Postfachdatenbank gespeichert ist, der Name MDEL vorangestellt, um anzugeben, dass es zum Löschen markiert wurde. Verwenden Sie zur Freisetzung des Speicherplatzes und des Alias das Cmdlet Remove-Mailbox, um diese Websitepostfächer manuell aus der Postfachdatenbank zu entfernen.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

Der Parameter "DomainController" gibt den Domänencontroller an, der von diesem Cmdlet verwendet wird, um aus Active Directory Daten zu lesen oder hineinzuschreiben. Der Domänencontroller kann anhand seines vollqualifizierten Domänennamens (Fully Qualified Domain Name, FQDN) ermittelt werden. Beispiel: dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

Der Parameter Identity gibt die Identität des Websitepostfachs an. Sie können jeden beliebigen Wert verwenden, sofern er das Postfach eindeutig kennzeichnet. Beispiel:

  • Name
  • Alias
  • Distinguished Name (DN)
  • Distinguished Name (DN)
  • Kanonischer DN
  • GUID
Type:RecipientIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ReadFromDomainController

Die Option ReadFromDomainController gibt an, dass Informationen von einem Domänencontroller in der Domäne des Benutzers gelesen werden sollen. Sie müssen keinen Wert für diese Option angeben.

Der Befehl Set-AdServerSettings -ViewEntireForest $true zum Einschließen aller Objekte in der Gesamtstruktur erfordert den ReadFromDomainController-Switch. Andernfalls könnte der Befehl einen globalen Katalog verwenden, der veraltete Informationen enthält. Außerdem müssen Sie möglicherweise mehrere Iterationen des Befehls mit dem ReadFromDomainController-Switch ausführen, um die Informationen abzurufen.

Standardmäßig ist der Empfängerbereich auf die Domäne festgelegt, in der sich Ihre Exchange-Server befinden.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ResultSize

Der ResultSize-Parameter gibt die maximale Anzahl von zurückzugebenden Ergebnissen an. Wenn Sie alle Anforderungen zurückgeben möchten, die der Abfrage entsprechen, verwenden Sie unlimited als Wert für diesen Parameter. Der Standardwert ist 1000.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Eingaben

Input types

Eingabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Eingabetyp für ein Cmdlet leer ist, akzeptiert das Cmdlet diese Eingabedaten nicht.

Ausgaben

Output types

Informationen zu den Rückgabetypen, die auch als Ausgabetypen bezeichnet werden, die dieses Cmdlet akzeptiert, finden Sie unter Cmdlet Input and Output Types. Wenn das Feld Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.