Set-Group (RTM)

  • Artikel

 

Gilt für: Exchange Server 2007

Letztes Änderungsdatum des Themas: 2007-06-17

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

Syntax

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

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

Set-Group [-DisplayName <String>] [-DomainController <Fqdn>] [-Instance <WindowsGroup>] [-ManagedBy <GeneralRecipientIdParameter>] [-Name <String>] [-Notes <String>] [-PhoneticDisplayName <String>] [-SimpleDisplayName <String>] [-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. Weitere Informationen zum Cmdlet Set-DynamicDistributionGroup finden Sie unter Set-DynamicDistributionGroup (RTM).

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

  • die Rolle Exchange-Empfängeradministrator

  • 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.

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.

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.

Notizen

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 (einschließlich) 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.

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"