Remove-Mailbox
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Letztes Änderungsdatum des Themas: 2007-06-28
Verwenden Sie das Cmdlet Remove-Mailbox zum Löschen des Benutzerkontos, das einem bestimmten Postfach aus dem Active Directory-Verzeichnisdienst zugeordnet ist, sowie zum Verarbeiten des zugehörigen getrennten Postfachs gemäß den angegebenen Parametern.
Syntax
Remove-Mailbox -Identity <MailboxIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-Permanent <$true | $false>] [-WhatIf [<SwitchParameter>]]
Remove-Mailbox -Database <DatabaseIdParameter> -StoreMailboxIdentity <StoreMailboxIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Das Cmdlet Remove-Mailbox entfernt das Benutzerkonto aus Active Directory, das einem bestimmten Postfach zugeordnet ist, und verarbeitet dann das zugehörige getrennte Postfach gemäß den angegebenen Parametern.
Verwenden Sie den Parameter Identity allein, um das Postfach vom Benutzer zu trennen und das Benutzerobjekt aus Active Directory zu entfernen. Das Postfachobjekt ist auch weiterhin vorhanden. Standardmäßig verbleibt dieses Postfach 30 Tage lang in der Exchange-Datenbank und wird anschließend gelöscht.
Verwenden Sie die Parameter Identity und Permanent, um das Postfach vom Benutzer zu trennen, das Benutzerobjekt aus Active Directory zu entfernen und das Postfachobjekt aus der Exchange-Datenbank zu entfernen. Das Postfachobjekt verbleibt nicht wie ein getrenntes Postfach in der Exchange-Datenbank.
Verwenden Sie die Parameter Database und StoreMailboxIdentity, um ein Postfachobjekt aus der Exchange-Datenbank zu entfernen. In diesem Fall wurde das Postfachobjekt bereits vom Benutzer getrennt. Wenn Sie z. B. das Cmdlet Disable-Mailbox ausführen, ist das Exchange-Postfachobjekt zwar noch vorhanden, jedoch vom Active Directory-Benutzerobjekt getrennt. Sie können die Parameter Database und StoreMailboxIdentity verwenden, um dieses getrennte Postfachobjekt zu entfernen.
Damit Sie das Cmdlet Remove-Mailbox ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:
Exchange-Empfängeradministrator-Rolle
Konten-Operator-Rolle für die entsprechenden Active Directory-Container
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 |
|---|---|---|---|
Database |
Erforderlich |
Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter |
Der Database-Parameter gibt die Datenbank an, die das Postfachobjekt enthält. Einer der folgenden Werte kann verwendet werden:
Wenn Sie den Servernamen nicht angeben, sucht das Cmdlet auf dem lokalen Server nach der Datenbank. Wenn Sie über mehrere Datenbanken mit gleichem Namen auf dem gleichen Server verfügen, müssen Sie die Speichergruppe angeben. Dieser Parameter muss gemeinsam mit dem Parameter StoreMailboxIdentity verwendet werden. Der Parameter Identity kann nicht gemeinsam mit dem Parameter Database verwendet werden. Wenn Sie ein Postfach vom zugehörigen Benutzer getrennt haben und das Postfachobjekt aus dem Exchange-Informationsspeicher entfernen möchten, verwenden Sie die Parameter Database und StoreMailboxIdentity. |
Identity |
Erforderlich |
Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter |
Der Parameter Identity gibt das zu entfernende Postfachobjekt an. Einer der folgenden Werte kann verwendet werden:
Der Parameter Identity kann nicht gemeinsam mit dem Parameter Database verwendet werden. |
StoreMailboxIdentity |
Erforderlich |
Microsoft.Exchange.Configuration.Tasks.StoreMailboxIdParameter |
Der StoreMailboxIdentity-Parameter gibt das zu entfernende Postfachobjekt an. Der Parameter StoreMailboxIdentity wird in Kombination mit dem Parameter Database verwendet, um ein Postfachobjekt aus der Exchange-Datenbank zu entfernen. Wenn Sie ein Postfach vom zugehörigen Benutzer getrennt haben und das Postfachobjekt aus dem Exchange-Informationsspeicher entfernen möchten, verwenden Sie die Parameter Database und StoreMailboxIdentity. |
Confirm |
Optional |
System.Management.Automation.SwitchParameter |
Der Confirm-Parameter bewirkt eine Unterbrechung der Befehlsausführung und zwingt Sie, die Aktion des Befehls zu bestätigen, bevor die Verarbeitung fortgesetzt wird. Für den Confirm-Parameter muss kein Wert angegeben werden. |
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
Der DomainController-Parameter gibt den Domänencontroller an, der diese Konfigurationsänderung in Active Directory schreibt. Verwenden Sie den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Domänencontrollers, der verwendet werden soll. |
IgnoreDefaultScope |
Optional |
System.Management.Automation.SwitchParameter |
Mit dem IgnoreDefaultScope-Parameter wird der Befehl angewiesen, die Standardeinstellung für den Empfängerbereich für die Exchange-Verwaltungsshell zu ignorieren und die ganze Gesamtstruktur als Bereich zu verwenden. Dadurch kann der Befehl auf Active Directory-Objekte zugreifen, die sich aktuell nicht im Standardbereich befinden. Die Verwendung des IgnoreDefaultScope-Parameters bringt die folgenden Einschränkungen mit sich:
|
Permanent |
Optional |
System.Boolean |
Der Permanent-Parameter trennt, wenn er in Kombination mit dem Parameter Identity verwendet wird, das Postfach vom Benutzer, entfernt das zugehörige Benutzerobjekt aus Active Directory und entfernt das Postfachobjekt aus der Exchange-Datenbank. Die beiden möglichen Werte für diesen Parameter sind "$true" oder "$false". Der Standardwert lautet "$false". |
WhatIf |
Optional |
System.Management.Automation.SwitchParameter |
Der Parameter WhatIf weist den Befehl an, die für das Objekt ausgeführten Aktionen lediglich zu simulieren. Durch Verwendung des WhatIf-Parameters können Sie eine Vorschau der Änderungen anzeigen, ohne diese Änderungen wirklich übernehmen zu müssen. Für den WhatIf-Parameter muss kein Wert angegeben werden. |
Eingabetypen
Rückgabetypen
Fehler
| Fehler | Beschreibung |
|---|---|
|
Ausnahmen
| Ausnahmen | Beschreibung |
|---|---|
|
Beispiel
Das erste Beispiel zeigt, wie das Postfach des Benutzers John Peoples (john) vom Benutzerkonto getrennt und das Postfachobjekt aus Active Directory entfernt wird. Das Postfach verbleibt für den Aufbewahrungszeitraum für gelöschte Postfächer, der für die Postfachdatenbank konfiguriert ist, in der Exchange-Datenbank.
Das zweite Beispiel zeigt, wie das Postfach des Benutzers John Peoples (john) vom Benutzerkonto getrennt, das Postfachobjekt aus Active Directory entfernt und das Postfach aus der Exchange-Datenbank entfernt wird.
Im dritten Beispiel wird veranschaulicht, wie das Postfach von John Peoples aus der Exchange-Datenbank entfernt wird, unter der Annahme, dass das Postfach bereits vom Benutzer getrennt wurde. Dieses Beispiel zeigt, wie das Cmdlet Get-MailboxStatistics verwendet wird, um den GUID-Wert des Postfachs mithilfe des Anzeigenamens des getrennten Postfachs abzurufen. Dieser Wert wird für den Parameter StoreMailboxIdentity des Cmdlets Remove-Mailbox benötigt.
Remove-Mailbox -Identity contoso\john
Remove-Mailbox -Identity contoso\john -Permanent $true
$Temp = Get-MailboxStatistics | Where {$_.DisplayName -eq 'John Peoples'}
Remove-Mailbox -Database Server01\Database01 -StoreMailboxIdentity $Temp.MailboxGuid