Set-Group

  • Artikel

 

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

Letztes Änderungsdatum des Themas: 2009-05-12

Mithilfe des Cmdlets Set-Group können Sie die Einstellungen einer vorhandenen Microsoft Windows-Gruppe ändern.

Syntax

Set-Group -Identity <GroupIdParameter> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-ManagedBy <GeneralRecipientIdParameter>] [-Name <String>] [-Notes <String>] [-PhoneticDisplayName <String>] [-SimpleDisplayName <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Set-Group -Identity <GroupIdParameter> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-ManagedBy <GeneralRecipientIdParameter>] [-Name <String>] [-Notes <String>] [-PhoneticDisplayName <String>] [-SimpleDisplayName <String>] [-Universal <SwitchParameter>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Set-Group [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-Instance <WindowsGroup>] [-ManagedBy <GeneralRecipientIdParameter>] [-Name <String>] [-Notes <String>] [-PhoneticDisplayName <String>] [-SimpleDisplayName <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Detaillierte Beschreibung

Mithilfe des Cmdlets Set-Group können Sie die Einstellungen von Gruppenobjekten ändern, die in Active Directory-Benutzer und -Computer angezeigt werden. Wenn es sich bei der Gruppe um eine E-Mail-aktivierte Sicherheitsgruppe oder eine Verteilergruppe handelt, können Sie das Cmdlet Set-DistributionGroup verwenden, um andere Microsoft Exchange Server 2007-Einstellungen zu ändern, die über das Cmdlet Set-Group nicht verfügbar sind.

Dynamische Verteilergruppen können Sie nicht mit dem Cmdlet Set-Group ändern. Zum Ändern von dynamischen Verteilergruppen verwenden Sie das Cmdlet Set-DynamicDistributionGroup.

Damit Sie das Cmdlet Set-Group 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

Identity

Erforderlich

Microsoft.Exchange.Configuration.Tasks.GroupIdParameter

Der Parameter Identity gibt das zu ändernde Objekt an. Der Parameter Identity akzeptiert jeden der folgenden Werte für die Gruppe:

  • Distinguished Name (DN)

  • Kanonischer Name

  • GUID

  • Name

  • Anzeigename

Der Parameter Identity kann nicht zusammen mit dem Parameter Instance verwendet werden.

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.

DisplayName

Optional

System.String

Der Parameter DisplayName gibt den Namen der Gruppe in der Exchange-Verwaltungskonsole und in der globalen Adressliste (GAL) von Exchange an. Dieser Parameter ist nur für E-Mail-aktivierte Gruppen von Bedeutung.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

Um den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Domänencontrollers anzugeben, der diese Konfigurationsänderung in Active Directory schreibt, fügen Sie den Parameter DomainController hinzu.

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.

Instance

Optional

Microsoft.Exchange.Data.Directory.Management.WindowsGroup

Der Parameter Instance ermöglicht das Übergeben eines vollständigen Objekts an den zu verarbeitenden Befehl. Er wird hauptsächlich in Skripts verwendet, in denen ein vollständiges Objekt an den Befehl übergeben werden muss.

Der Parameter Instance kann nicht zusammen mit dem Parameter Identity verwendet werden.

ManagedBy

Optional

Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter

Der Parameter ManagedBy gibt den Namen des Benutzers, der Gruppe oder des Kontakts an, der auf der Registerkarte Verwaltet von des Objekts Active Directory angezeigt wird. Für diesen Parameter kann jeder der folgenden Werte verwendet werden:

  • Distinguished Name (DN)

  • Kanonischer Name

  • GUID

  • Name

  • Anzeigename

Name

Optional

System.String

Der Parameter Name gibt den Namen der Gruppe an. Der Parameter Name gibt den Namen der Gruppe in Active Directory-Benutzer und -Computer und im Feld Gruppenname in der Exchange-Verwaltungskonsole an, wenn es sich um eine E-Mail-aktivierte Gruppe handelt.

Notes

Optional

System.String

Der Parameter Notes gibt die Notizen an, die die Aufgabe der Gruppe beschreiben.

PhoneticDisplayName

Optional

System.String

Der Parameter PhoneticDisplayName gibt eine phonetische Aussprache des Parameters DisplayName an.

Dieser Parameterwert kann höchstens 255 Zeichen umfassen. Weitere Informationen zum Parameter PhoneticDisplayName und der Spracherkennung finden Sie unter Informationen über Verzeichnissuchen bei der automatischen Spracherkennung.

SimpleDisplayName

Optional

System.String

Der Parameter SimpleDisplayName zeigt eine alternative Beschreibung des Objekts an, wenn nur eine begrenzte Menge von Zeichen zulässig ist. Diese begrenzte Zeichenmenge umfasst die ASCII-Zeichen 26 bis 126. SimpleDisplayName ist nur für E-Mail-aktivierte Objekte gültig.

Universal

Optional

System.Management.Automation.SwitchParameter

Der Parameter Universal ändert den Gruppenbereich von global oder domain local in universal.

UseRusServer

Optional

System.String
noteHinweis:
Dieser Parameter steht nur in Exchange 2007 SP2 zur Verfügung.

Der Parameter UseRusServer weist den Befehl an, den angegebenen Postfachserver, auf dem der Adresslistendienst ausgeführt wird, zum Abrufen und Festlegen von Postfach- und Active Directory-Benutzerattributen zu verwenden.

Der Adresslistendienst ist eine Komponente des Exchange-Systemaufsichtsdiensts. Der Adresslistendienst erstellt und verwaltet Exchange-spezifische Attributwerte in Active Directory. Sie können den Adresslistendienst zum Aktualisieren von Empfängerobjekten in einer Domäne mithilfe bestimmter Informationen verwenden, z. B. anhand von Adresslistenmitgliedschaft und E-Mail-Adressen.

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.

WindowsEmailAddress

Optional

Microsoft.Exchange.Data.SmtpAddress

Der Parameter WindowsEmailAddress gibt den Wert des Felds E-Mail des Active Directory-Objekts an.

Eingabetypen

Rückgabetypen

Fehler

Fehler Beschreibung

 

 

Ausnahmen

Ausnahmen Beschreibung

 

 

Beispiel

Das folgende Codebeispiel zeigt, wie der Befehl Set-Group verwendet wird, um die folgenden Änderungen an einer vorhandenen globalen Sicherheitsgruppe mit dem Namen Legal Department vorzunehmen:

  • Ändern Sie den Gruppenbereich in universell.

  • Fügen Sie einen Wert verified für Notes hinzu.

Set-Group -Identity "Legal Department" -Universal -Notes "verified"