Remove-Mailbox
Dieses Cmdlet ist der lokalen Bereitstellung von Exchange und im cloudbasierten Dienst verfügbar. Einige Parameter und Einstellungen gelten exklusiv für die eine oder andere Umgebung.
Verwenden des Remove-Mailbox-Cmdlet zum Löschen von Postfächern und der zugehörigen Benutzerkonten.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
Remove-Mailbox
[-Identity] <MailboxIdParameter>
[-Permanent <Boolean>]
[-Arbitration]
[-AuditLog]
[-AuxAuditLog]
[-Confirm]
[-DomainController <Fqdn>]
[-Force]
[-IgnoreDefaultScope]
[-IgnoreLegalHold]
[-Migration]
[-PublicFolder]
[-RemoveArbitrationMailboxWithOABsAllowed]
[-RemoveLastArbitrationMailboxAllowed]
[-SupervisoryReviewPolicy]
[-WhatIf]
[<CommonParameters>]
Remove-Mailbox
-Database <DatabaseIdParameter>
-StoreMailboxIdentity <StoreMailboxIdParameter>
[-Arbitration]
[-AuditLog]
[-AuxAuditLog]
[-Confirm]
[-DomainController <Fqdn>]
[-Force]
[-IgnoreDefaultScope]
[-IgnoreLegalHold]
[-Migration]
[-PublicFolder]
[-RemoveArbitrationMailboxWithOABsAllowed]
[-RemoveLastArbitrationMailboxAllowed]
[-SupervisoryReviewPolicy]
[-WhatIf]
[<CommonParameters>]
Remove-Mailbox
[-Identity] <MailboxIdParameter>
[-PermanentlyDelete]
[-Confirm]
[-Force]
[-Migration]
[-PublicFolder]
[-RemoveCNFPublicFolderMailboxPermanently]
[-WhatIf]
[<CommonParameters>]
Beschreibung
Verwenden Sie den Parameter Identity allein, um das Postfach vom Benutzer zu trennen und das Benutzerkonto zu entfernen. Das Postfach ist weiterhin vorhanden und bleibt erhalten, bis der Aufbewahrungszeitraum für gelöschte Postfächer abgelaufen ist. Der Aufbewahrungszeitraum für gelöschte Postfächer wird durch die MailboxRetention-Eigenschaft für die Postfachdatenbank oder für das Postfach selbst gesteuert, wenn die UseDatabaseRetentionDefaults-Eigenschaft false ist.
Verwenden Sie die Parameter Identity und Permanent, um das Postfach vom Benutzer zu trennen, das Benutzerkonto zu entfernen und das Postfach sofort aus der Postfachdatenbank zu entfernen. Das Postfach verbleibt nicht als getrenntes Postfach in der Postfachdatenbank.
Verwenden Sie das Cmdlet Disable-Mailbox, um das Postfach vom Benutzerkonto zu trennen, aber das Benutzerkonto beizubehalten. Das Postfach wird beibehalten, bis der Aufbewahrungszeitraum für gelöschte Postfächer für die Datenbank oder das Postfach abläuft, und dann wird das Postfach endgültig gelöscht (gelöscht). Oder Sie können das getrennte Postfach sofort bereinigen, indem Sie die Parameter Database und StoreMailboxIdentity im Cmdlet Remove-Mailbox verwenden.
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
Remove-Mailbox -Identity "John Rodman"
In diesem Beispiel werden das Postfach und das Benutzerkonto für den Benutzer John Rodman entfernt. Das Postfach verbleibt für den Aufbewahrungszeitraum für gelöschte Postfächer, der für die Postfachdatenbank konfiguriert ist, in der Datenbank.
Beispiel 2
Remove-Mailbox -Identity "John Rodman" -Permanent $true
In lokalem Exchange entfernt dieses Beispiel das Postfach und das Benutzerkonto für den Benutzer mit dem Namen John Rodman. Das Postfach wird sofort und endgültig aus der Postfachdatenbank entfernt.
Beispiel 3
$Temp = Get-Mailbox | Where {$_.DisplayName -eq 'John Rodman'}
Remove-Mailbox -Database Server01\Database01 -StoreMailboxIdentity $Temp.MailboxGuid
In lokalem Exchange wird in diesem Beispiel das Postfach von John Rodman aus der Postfachdatenbank entfernt, nachdem das Postfach vom Benutzerkonto getrennt wurde. Im Beispiel wird das Cmdlet Get-Mailbox verwendet, um den Wert der Postfach-GUID des getrennten Postfachs abzurufen, der für den StoreMailboxIdentity-Parameter erforderlich ist.
Beispiel 4
Get-Mailbox -Identity Laura -SoftDeletedMailbox | Remove-Mailbox -PermanentlyDelete
In Exchange Online entfernt dieses Beispiel das angegebene vorläufig gelöschte Postfach.
Parameter
-Arbitration
Dieser Parameter ist nur im lokalen Exchange verfügbar.
Der Schalter "Schiedsverfahren" ist erforderlich, um Schiedspostfächer zu entfernen. Sie müssen keinen Wert für diese Option angeben.
Schiedspostfächer sind Systempostfächer, die zum Speichern verschiedener Arten von Systemdaten und zum Verwalten des Messaginggenehmigungsworkflows verwendet werden.
Verwenden Sie diesen Schalter nicht, um Vermittlungspostfächer zu entfernen, die zum Speichern von Überwachungsprotokolleinstellungen oder -daten verwendet werden. Verwenden Sie stattdessen die Optionen AuditLog oder AuxAuditLog.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-AuditLog
Dieser Parameter ist im lokalen Exchange verfügbar.
Der Schalter AuditLog ist erforderlich, um Überwachungsprotokollpostfächer zu entfernen. Sie müssen keinen Wert für diese Option angeben.
Überwachungsprotokollpostfächer sind Vermittlungspostfächer, in denen Überwachungsprotokolleinstellungen gespeichert werden.
Verwenden Sie diesen Schalter nicht, um andere Arten von Vermittlungspostfächern zu entfernen. Verwenden Sie stattdessen den Vermittlungsschalter.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019 |
-AuxAuditLog
Dieser Parameter ist nur im lokalen Exchange verfügbar.
Der Schalter AuxAuditLog ist erforderlich, um zusätzliche Überwachungsprotokollpostfächer zu entfernen. Sie müssen keinen Wert für diese Option angeben.
Überwachungsprotokollpostfächer sind Vermittlungspostfächer, in denen Überwachungsprotokolleinstellungen gespeichert werden.
Verwenden Sie diesen Schalter nicht, um andere Arten von Vermittlungspostfächern zu entfernen. Verwenden Sie stattdessen den Vermittlungsschalter.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019 |
-Confirm
Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie diese Option sich auf das Cmdlet auswirkt, hängt davon ab, ob für die Option vor dem Fortfahren eine Bestätigung erforderlich ist.
- Destruktive Cmdlets (z. B. Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen:
-Confirm:$false
. - Die meisten anderen Cmdlets (z. B. New-* und Set-*-Cmdlets) verfügen nicht über eine integrierte Pause. Bei diesen Cmdlets führt das Angeben der Option "Confirm" ohne einen Wert eine Pause ein, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Database
Dieser Parameter ist nur im lokalen Exchange verfügbar.
Der Parameter Database gibt die Exchange-Datenbank an, die das Postfach enthält, das Sie entfernen möchten. Sie können jeden beliebigen Wert verwenden, sofern er die Datenbank eindeutig kennzeichnet. Beispiel:
- Name
- Distinguished Name (DN)
- GUID
Wenn Sie diesen Parameter mit dem Parameter StoreMailboxIdentity verwenden, um das Postfach zu identifizieren und zu entfernen, wird das Postfach sofort und dauerhaft aus der Datenbank gelöscht, sodass Sie die Verbindung mit dem Postfach nicht wiederherstellen oder wiederherstellen können. Sie können keinen dieser Parameter zusammen mit dem Identity-Parameter verwenden.
Wenn Sie ein Postfach vom zugeordneten Benutzer getrennt haben und das Postfachobjekt aus dem Exchange-Speicher entfernen möchten, verwenden Sie die Parameter Database und StoreMailboxIdentity.
Type: | DatabaseIdParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DomainController
Dieser Parameter ist im lokalen Exchange verfügbar.
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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Force
Der Schalter „Erzwingen“ blendet Warnungs- oder Bestätigungsmeldungen aus. Sie müssen keinen Wert für diese Option angeben.
Sie können diesen Switch verwenden, um Aufgaben in Fällen programmgesteuert auszuführen, in denen die administrative Eingabe unangemessen ist.
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, Exchange Online |
-Identity
Der Parameter Identity identifiziert das zu entfernende Postfach. Sie können jeden beliebigen Wert verwenden, sofern er das Postfach eindeutig kennzeichnet. Beispiel:
- Name
- Alias
- Distinguished Name (DN)
- Distinguished Name (DN)
- Domäne\benutzername
- E-Mail-Adresse
- GUID
- LegacyExchangeDN
- SamAccountName
- Benutzer-ID oder User Principal Name (UPN)
Verwenden Sie diesen Parameter nicht zusammen mit dem Parameter Database.
Type: | MailboxIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-IgnoreDefaultScope
Dieser Parameter ist nur im lokalen Exchange verfügbar.
Die Option IgnoreDefaultScope weist den Befehl an, die Standardeinstellung für den Empfängerbereich für die Exchange PowerShell-Sitzung zu ignorieren und die komplette Gesamtstruktur als Bereich zu verwenden. Sie müssen keinen Wert für diese Option angeben.
Dieser Switch ermöglicht dem Befehl den Zugriff auf Active Directory-Objekte, die derzeit nicht im Standardbereich verfügbar sind, führt aber auch die folgenden Einschränkungen ein:
- Sie können den Parameter DomainController nicht verwenden. Der Befehl verwendet automatisch einen geeigneten globalen Katalogserver.
- Sie können nur den DN für den Identitätsparameter verwenden. Andere Formen der Identifikation wie Aliasnamen oder GUIDs werden nicht akzeptiert.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-IgnoreLegalHold
Dieser Parameter ist nur im lokalen Exchange verfügbar.
Der IgnoreLegalHold-Schalter ignoriert den Status der aufbewahrungsrechtlichen Aufbewahrung des Benutzers. Sie müssen keinen Wert für diese Option angeben.
Wenn Sie den Benutzer deaktivieren oder entfernen, wird auch das cloudbasierte Postfach des Benutzers, das sich in rechtlicher Aufbewahrung befindet, deaktiviert oder entfernt.
Nachdem Sie ein Postfach deaktiviert oder entfernt haben, können Sie es nicht mehr in eine Ermittlungssuche einschließen. Wenn Sie ein Postfach deaktivieren, wird es vom Benutzerkonto getrennt. Getrennte Postfächer und entfernte Postfächer werden nach Ablauf des Aufbewahrungszeitraums für gelöschte Postfächer endgültig aus der Postfachdatenbank gelöscht. Sie können jedoch auch ein Postfach entfernen und sofort aus der Postfachdatenbank löschen. Wenden Sie sich an die Rechts- oder Personalabteilung Ihrer Organisation, bevor Sie ein Postfach deaktivieren oder entfernen, das sich in rechtlicher Aufbewahrung befindet.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Migration
Der Migrationsschalter ist erforderlich, um Migrationspostfächer zu entfernen. Sie müssen bei dieser Option keinen Wert angeben.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Permanent
Dieser Parameter ist im lokalen Exchange verfügbar.
Der Parameter Permanent gibt an, ob das Postfach dauerhaft aus der Postfachdatenbank gelöscht werden soll. Gültige Werte sind:
- $true: Das Postfach wird sofort und endgültig gelöscht (gelöscht). Sie können das Postfach nicht wieder verbinden oder wiederherstellen.
- $false: Das Postfach wurde deaktiviert und beibehalten, bis der Aufbewahrungszeitraum für gelöschte Postfächer abläuft. Sie können das Postfach wieder verbinden oder wiederherstellen, bis der Aufbewahrungszeitraum für gelöschte Postfächer abgelaufen ist. Dies ist der Standardwert.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-PermanentlyDelete
Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.
Der Schalter PermanentDelete löscht das Postfach sofort und endgültig (löscht) und verhindert, dass Sie das Postfach wiederherstellen oder wiederherstellen können. Sie müssen keinen Wert für diese Option angeben.
Hinweise:
- Dieser Schalter funktioniert nur für Postfächer, die bereits gelöscht wurden, aber weiterhin wiederherstellbar sind (als vorläufig gelöschte Postfächer bezeichnet). Verwenden Sie das Cmdlet Get-Mailbox, um das vorläufig gelöschte Postfach zu identifizieren, und leiten Sie dann die Ergebnisse an das Cmdlet Remove-Mailbox weiter, wie in Beispiel 4 in diesem Thema gezeigt.
- Dieser Schalter funktioniert nicht für vorläufig gelöschte Postfächer, die sich in In-Place Oder Beweissicherung befinden (als inaktive Postfächer bezeichnet).
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-PublicFolder
Der Schalter PublicFolder ist erforderlich, um Postfächer für öffentliche Ordner zu entfernen. Sie müssen keinen Wert für diese Option angeben.
Postfächer für öffentliche Ordner wurden eigens entworfen, um die Hierarchie und Inhalte von öffentlichen Ordnern zu speichern.
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, Exchange Online |
-RemoveArbitrationMailboxWithOABsAllowed
Dieser Parameter ist nur im lokalen Exchange verfügbar.
Die Option RemoveArbitrationMailboxWithOABsAllowed gibt an, ob die Überprüfungen von Offlineadressbüchern (OABs) im angegebenen Vermittlungspostfach, das entfernt wird, umgangen werden sollen. Sie müssen bei dieser Option keinen Wert angeben.
Wenn Sie diese Option verwenden, wird das Vermittlungspostfach entfernt, auch wenn OABs im Postfach vorhanden sind.
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 |
-RemoveCNFPublicFolderMailboxPermanently
Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.
{{ Fill RemoveCNFPublicFolderMailboxPermanently Description }}
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-RemoveLastArbitrationMailboxAllowed
Dieser Parameter ist nur im lokalen Exchange verfügbar.
Die Option RemoveLastArbitrationMailboxAllowed gibt an, ob das angegebene Postfach entfernt wird, auch wenn es sich dabei um das letzte Vermittlungspostfach in der Organisation handelt. Sie müssen bei dieser Option keinen Wert angeben.
Wenn Sie das letzte Vermittlungspostfach in der Organisation entfernen, stehen keine von einem Benutzer erstellten Verteilergruppen oder moderierten Empfänger zur Verfügung.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-StoreMailboxIdentity
Dieser Parameter ist im lokalen Exchange verfügbar.
Der Parameter StoreMailboxIdentity gibt das zu entfernende Postfach an. Wenn Sie diesen Parameter verwenden, identifizieren Sie das Postfach anhand seines MailboxGUID-Werts. Sie finden den GUID-Wert mit den Cmdlets Get-Mailbox oder Get-MailboxStatistics.
Wenn Sie diesen Parameter mit dem Database-Parameter verwenden, um das Postfach zu identifizieren und zu entfernen, wird das Postfach sofort und endgültig aus der Datenbank gelöscht, sodass Sie die Verbindung mit dem Postfach nicht wiederherstellen oder wiederherstellen können. Sie können keinen dieser Parameter mit dem Parameter Identity verwenden.
Wenn Sie ein Postfach vom zugeordneten Benutzer getrennt haben und das Postfachobjekt aus dem Exchange-Speicher entfernen möchten, verwenden Sie die Parameter Database und StoreMailboxIdentity.
Type: | StoreMailboxIdParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-SupervisoryReviewPolicy
Dieser Parameter ist im lokalen Exchange verfügbar.
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019 |
-WhatIf
Die Option "WhatIf" simuliert die Aktionen des Befehls. Sie können diesen Switch verwenden, um die Änderungen anzuzeigen, die auftreten würden, ohne diese Änderungen tatsächlich anzuwenden. Sie müssen keinen Wert für diese Option angeben.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
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.