Remove-MailContact
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-MailContact, um einen vorhandenen E-Mail-aktivierten Kontakt aus dem Active Directory-Verzeichnisdienst zu löschen.
Syntax
Remove-MailContact -Identity <MailContactIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Das Cmdlet Remove-MailContact entfernt ein vorhandenes E-Mail-aktiviertes Kontaktobjekt aus dem Active Directory-Verzeichnisdienst.
Damit Sie das Cmdlet Remove-MailContact 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 Microsoft Exchange Server 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.
Parameter
Parameter | Erforderlich | Typ | Beschreibung |
---|---|---|---|
Identity |
Erforderlich |
Microsoft.Exchange.Configuration.Tasks.MailContactIdParameter |
Dieser Parameter gibt die Identität des E-Mail-Kontakts an. |
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
Um den vollqualifizierten Domänennamen des Domänencontrollers anzugeben, der diese Konfigurationsänderung in Active Directory schreibt, fügen Sie dem Befehl den Parameter DomainController hinzu. |
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. |
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:
|
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
In diesem Beispiel wird mithilfe des Befehls Remove-MailContact der E-Mail-aktivierte Kontakt namens "John Peoples" aus Active Directory entfernt.
Remove-MailContact -Identity contoso.com/john