Remove-DynamicDistributionGroup

  • Artikel

 

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

Letztes Änderungsdatum des Themas: 2007-09-27

Verwenden Sie das Cmdlet Remove-DynamicDistributionGroup, um eine vorhandene dynamische Verteilergruppe zu löschen.

Syntax

Remove-DynamicDistributionGroup -Identity <DynamicGroupIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Mithilfe des Cmdlets Remove-DynamicDistributionGroup können Sie eine vorhandene dynamische Verteilergruppe löschen.

Damit Sie das Cmdlet Remove-DynamicDistributionGroup ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:

  • die Rolle Exchange-Empfängeradministrator

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

Identity

Erforderlich

Microsoft.Exchange.Configuration.Tasks.DynamicGroupIdParameter

Der Parameter Identity wird zur Identifizierung der zu entfernenden dynamischen Verteilergruppe verwendet. Der Parameter Identity akzeptiert jeden der folgenden Werte für die dynamische Verteilergruppe:

  • Distinguished Name (DN)

  • Kanonischer Name

  • GUID

  • Name

  • Anzeigename

  • Alias

  • Legacy-Exchange-DN

  • Primäre SMTP-E-Mail-Adresse (Simple Mail Transfer Protocol)

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 Parameter DomainController gibt den vollqualifizierten Domänennamen des Domänencontrollers an, der diese Konfigurationsänderung in den Active Directory-Verzeichnisdienst schreibt.

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:

  • Der DomainController-Parameter kann nicht verwendet werden. Der Befehl verwendet automatisch einen geeigneten globalen Katalogserver.

  • Für den Identity-Parameter kann nur der DN verwendet werden. Andere Formen der Identifikation, wie etwa Aliase oder GUIDs, werden nicht akzeptiert.

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 folgende Codebeispiel veranschaulicht die Verwendung des Cmdlets Remove-DynamicDistributionGroup zum Löschen einer dynamischen Verteilergruppe namens Test Users unter Verwendung ihres Namens.

Remove-DynamicDistributionGroup -Identity "Test Users"