Set-RoleGroup

Der Schalter BypassSecurityGroupManagerCheck gibt an, ob ein Benutzer, der kein Besitzer der Gruppe ist, die Gruppe ändern oder löschen soll. Sie müssen keinen Wert für diese Option angeben.

Wenn Sie nicht in der ManagedBy-Eigenschaft der Gruppe definiert sind, müssen Sie diesen Schalter in Befehlen verwenden, die die Gruppe ändern oder löschen. Um diesen Schalter verwenden zu können, benötigt Ihr Konto bestimmte Berechtigungen, die auf dem Gruppentyp basieren:

• Verteilergruppen oder E-Mail-aktivierte Sicherheitsgruppen: Sie müssen Mitglied der Rollengruppe Organisationsverwaltung sein oder die Rolle Sicherheitsgruppenerstellung und Mitgliedschaft zugewiesen haben.
• Verteilergruppen oder E-Mail-fähige Sicherheitsgruppen: Sie müssen ein Mitglied der Rollengruppe „Organisationsverwaltung“ sein, oder Ihnen muss die Rolle „Sicherheitsgruppenerstellung und -mitgliedschaft“ zugewiesen sein.

Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie diese Option sich auf das Cmdlet auswirkt, hängt davon ab, ob für die Option vor dem Fortfahren eine Bestätigung erforderlich ist.

• Destruktive Cmdlets (z. B. Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen: -Confirm:$false.
• Die meisten anderen Cmdlets (z. B. New-* und Set-*-Cmdlets) verfügen nicht über eine integrierte Pause. Bei diesen Cmdlets führt das Angeben der Option "Confirm" ohne einen Wert eine Pause ein, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen.

Der Parameter Description gibt die Beschreibung an, die beim Anzeigen der Rollengruppe mithilfe des Cmdlets Get-RoleGroup angezeigt wird. Schließen Sie die Beschreibung in Anführungszeichen (") ein.

Der Parameter DisplayName gibt den Anzeigenamen der Rollengruppe an. Wenn der Name Leerzeichen enthält, setzen Sie ihn in Anführungszeichen ("). Dieser Parameter hat eine maximale Länge von 256 Zeichen.

Dieser Parameter ist im lokalen Exchange verfügbar.

Der Parameter "DomainController" gibt den Domänencontroller an, der von diesem Cmdlet verwendet wird, um aus Active Directory Daten zu lesen oder hineinzuschreiben. Der Domänencontroller kann anhand seines vollqualifizierten Domänennamens (Fully Qualified Domain Name, FQDN) ermittelt werden. Beispiel: dc01.contoso.com.

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Der Schalter „Erzwingen“ blendet Warnungs- oder Bestätigungsmeldungen aus. Sie müssen keinen Wert für diese Option angeben.

Sie können diesen Switch verwenden, um Aufgaben in Fällen programmgesteuert auszuführen, in denen die administrative Eingabe unangemessen ist.

Der Parameter Identity gibt den Namen der Rollengruppe an, die geändert werden soll. Wenn der Name Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").

Dieser Parameter ist nur im lokalen Exchange verfügbar.

Der LinkedCredential-Parameter gibt den Benutzernamen und das Kennwort an, die für den Zugriff auf den durch den LinkedDomainController-Parameter angegebenen Domänencontroller verwendet werden.

Ein Wert für diesen Parameter setzt das Cmdlet "Get-Credential" voraus. Verwenden Sie den Wert (Get-Credential), um diesen Befehl anzuhalten und eine Aufforderung zur Eingabe von Anmeldeinformationen zu erhalten. Oder speichern Sie die Anmeldeinformationen in einer Variablen (beispielsweise $cred = Get-Credential), bevor Sie diesen Befehl ausführen, und verwenden Sie dann den Variablennamen ($cred) für diesen Parameter. Weitere Informationen finden Sie unter Get-Credential.

Sie können den Parameter LinkedCredential nur mit einer verknüpften Rollengruppe verwenden.

Dieser Parameter ist im lokalen Exchange verfügbar.

Der Parameter LinkedDomainController gibt den vollständig qualifizierten Domänennamen (FQDN) oder die IP-Adresse des Domänencontrollers in der Gesamtstruktur an, in der sich die fremde universelle Sicherheitsgruppe befindet. Der von Ihnen angegebene Domänencontroller wird zum Abrufen von Sicherheitsinformationen für die durch den Parameter LinkedForeignGroup angegebene fremde universelle Sicherheitsgruppe verwendet.

Sie können den Parameter LinkedDomainController nur mit einer verknüpften Rollengruppe verwenden.

Dieser Parameter ist im lokalen Exchange verfügbar.

Der Parameter LinkedForeignGroup gibt den Namen der fremden universellen Sicherheitsgruppe an, mit der Sie diese Rollengruppe verknüpfen möchten. Wenn der Name der fremden universellen Sicherheitsgruppe Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").

Sie können den Parameter LinkedForeignGroup nur zum Ändern der fremden universellen Sicherheitsgruppe verwenden, die mit einer vorhandenen Rollengruppe verknüpft ist. Sie können mit dem Cmdlet Set-RoleGroup keine Standardrollengruppe zu einer verknüpften Rollengruppe ändern. Sie müssen mit dem Cmdlet New-RoleGroup eine Rollengruppe erstellen.

Bei Verwendung des Parameters LinkedForeignGroup müssen Sie im Parameter LinkedDomainController einen Domänencontroller angeben.

Der Parameter ManagedBy gibt die Benutzer oder die universelle Sicherheitsgruppe an, die die Konfiguration einer Rollengruppe ändern können oder Mitglieder zu einer Rollengruppe hinzufügen oder Mitglieder aus einer Rollengruppe entfernen können. Die von Ihnen mit diesem Parameter angegebene Liste überschreibt die vorhandene Liste ManagedBy. Informationen zum Hinzufügen oder Entfernen einzelner Rollengruppen-Manager und weitere Informationen zum Ändern mehrwertiger Eigenschaften finden Sie unter Ändern mehrwertiger Eigenschaften.

Sie können den Namen, den Distinguished Name (DN) oder die primäre SMTP-Adresse des Benutzers oder der USG, die Sie hinzufügen möchten, verwenden. Wenn der Name des Benutzers oder der universellen Sicherheitsgruppe Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").

Wenn Sie mehrere Benutzer oder universelle Sicherheitsgruppen hinzufügen möchten, trennen Sie diese durch Kommata.

Der Parameter Name gibt den Namen der Rollengruppe an. Der Name kann bis zu 64 Zeichen umfassen. Wenn der Name Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

{{ Fill WellKnownObject Description }}

Der WhatIf-Schalter funktioniert in PowerShell für Sicherheitskonformität & nicht.

Die Option "WhatIf" simuliert die Aktionen des Befehls. Sie können diesen Switch verwenden, um die Änderungen anzuzeigen, die auftreten würden, ohne diese Änderungen tatsächlich anzuwenden. Sie müssen keinen Wert für diese Option angeben.