Set-EntraGroup
Legt die Eigenschaften für eine vorhandene Microsoft Entra ID Gruppe fest.
Syntax
Default (Standard)
Set-EntraGroup
-GroupId <String>
[-DisplayName <String>]
[-GroupTypes <System.Collections.Generic.List`1[System.String]>]
[-SecurityEnabled <Boolean>]
[-Description <String>]
[-MailEnabled <Boolean>]
[-MailNickname <String>]
[-Visibility <String>]
[-IsAssignableToRole <Boolean>]
[<CommonParameters>]
Beschreibung
Das Set-EntraGroup Cmdlet legt die Eigenschaften für eine vorhandene Microsoft Entra ID Gruppe fest. Geben Sie den GroupId Parameter an, der die Eigenschaften für eine vorhandene Microsoft Entra ID Gruppe festlegen soll.
Beispiele
Beispiel 1: Aktualisieren eines Gruppenanzeigenamens
Connect-Entra -Scopes 'Group.ReadWrite.All'
$group = Get-EntraGroup -Filter "displayName eq 'HelpDesk Team Leaders'"
Set-EntraGroup -GroupId $group.Id -DisplayName 'Global HelpDesk Team Leaders'
Mit diesem Befehl wird der Anzeigename einer angegebenen Gruppe in Microsoft Entra ID aktualisiert.
Beispiel 2: Aktualisieren einer Gruppenbeschreibung
Connect-Entra -Scopes 'Group.ReadWrite.All'
Get-EntraGroup -Filter "displayName eq 'HelpDesk Team Leaders'" | Set-EntraGroup -Description 'HelpDesk Team Leaders Global'
In diesem Beispiel wird veranschaulicht, wie eine Gruppenbeschreibung aktualisiert wird.
Beispiel 3: Aktualisieren eines Gruppen-E-Mail-Spitznamens
Connect-Entra -Scopes 'Group.ReadWrite.All'
$group = Get-EntraGroup -Filter "DisplayName eq 'HelpDesk Team Leaders'"
Set-EntraGroup -GroupId $group.Id -MailNickName 'newnickname'
Mit diesem Befehl wird der E-Mail-Spitzname einer angegebenen Gruppe in Microsoft Entra ID aktualisiert.
Beispiel 4: Aktualisieren einer aktivierten Gruppensicherheit
Connect-Entra -Scopes 'Group.ReadWrite.All'
$group = Get-EntraGroup -Filter "DisplayName eq 'HelpDesk Team Leaders'"
Set-EntraGroup -GroupId $group.Id -SecurityEnabled $True
Mit diesem Befehl wird die Sicherheit einer angegebenen Gruppe in Microsoft Entra ID aktualisiert.
Beispiel 5: Aktualisieren einer aktivierten Gruppen-E-Mail
Connect-Entra -Scopes 'Group.ReadWrite.All'
$group = Get-EntraGroup -Filter "DisplayName eq 'HelpDesk Team Leaders'"
Set-EntraGroup -GroupId $group.Id -MailEnabled $False
In diesem Beispiel wird veranschaulicht, wie ein Gruppenhaupthaupt aktiviert ist.
Beispiel 6: Aktualisieren einer Eigenschaft für eine Gruppe
Connect-Entra -Scopes 'Group.ReadWrite.All'
$group = Get-EntraGroup -Filter "DisplayName eq 'HelpDesk Team Leaders'"
Set-EntraGroup -GroupId $group.Id -Visibility 'Private' -GroupTypes 'DynamicMembership' -IsAssignableToRole $True
In diesem Beispiel wird veranschaulicht, wie eine Eigenschaft für eine vorhandene Microsoft Entra ID Gruppe aktualisiert wird.
Parameter
-Description
Gibt eine Beschreibung für die Gruppe an.
Parametereigenschaften
| Typ: | System.String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-DisplayName
Gibt einen Anzeigenamen für die Gruppe an.
Parametereigenschaften
| Typ: | System.String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-GroupId
Gibt die Objekt-ID einer Gruppe an.
Parametereigenschaften
| Typ: | System.String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Id |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-GroupTypes
Gibt an, dass die Gruppe eine dynamische Gruppe ist. Geben Sie zum Erstellen einer dynamischen Gruppe den Wert DynamicMembership an.
Parametereigenschaften
| Typ: | System.Collections.Generic.List`1[System.String] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-IsAssignableToRole
Diese Eigenschaft kann nur zum Zeitpunkt der Gruppenerstellung festgelegt und für eine vorhandene Gruppe nicht geändert werden.
Parametereigenschaften
| Typ: | System.Boolean |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-MailEnabled
Gibt an, ob diese Gruppe E-Mail aktiviert ist.
Parametereigenschaften
| Typ: | System.Boolean |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-MailNickname
Gibt einen E-Mail-Spitznamen für die Gruppe an.
Parametereigenschaften
| Typ: | System.String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-SecurityEnabled
Gibt an, ob die Gruppe sicherheitsfähig ist.
Parametereigenschaften
| Typ: | System.Boolean |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Visibility
Gibt die Sichtbarkeit der Inhalts- und Mitgliederliste der Gruppe an. Dieser Parameter kann einen der folgenden Werte annehmen:
- "Öffentlich": Jeder kann den Inhalt der Gruppe anzeigen.
- "Privat": Nur Mitglieder können den Inhalt der Gruppe anzeigen.
- "HiddenMembership": Nur Mitglieder können den Inhalt der Gruppe anzeigen, und nur Mitglieder, Besitzer, Globaler/Unternehmensadministrator, Benutzeradministrator und Helpdesk-Administratoren können die Mitgliederliste der Gruppe anzeigen.
Wenn kein Wert angegeben wird, lautet der Standardwert "Öffentlich".
Notes:
- Dieser Parameter ist nur für Gruppen gültig, für die der groupType auf "Unified" festgelegt ist.
- Wenn eine Gruppe dieses Attribut auf "HiddenMembership" festgelegt hat, kann es später nicht mehr geändert werden.
- Jeder kann einer Gruppe beitreten, die dieses Attribut auf "Öffentlich" festgelegt hat. Wenn das Attribut auf "Privat" oder "HiddenMembership" festgelegt ist, kann nur der Besitzer der Gruppe neue Mitglieder hinzufügen und Anforderungen für den Beitritt zur Gruppe benötigen eine Genehmigung des Besitzers.
Parametereigenschaften
| Typ: | System.String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.