Set-EntraGroup
Hiermee stelt u de eigenschappen voor een bestaande Microsoft Entra ID groep in.
Syntax
Default (Standaard)
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>]
Description
Met Set-EntraGroup de cmdlet worden de eigenschappen voor een bestaande Microsoft Entra ID groep ingesteld. Geef de GroupId parameter op om de eigenschappen voor een bestaande Microsoft Entra ID groep in te stellen.
Voorbeelden
Voorbeeld 1: De weergavenaam van een groep bijwerken
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'
Met deze opdracht wordt de weergavenaam van een opgegeven groep in Microsoft Entra ID bijgewerkt.
Voorbeeld 2: Een groepsbeschrijving bijwerken
Connect-Entra -Scopes 'Group.ReadWrite.All'
Get-EntraGroup -Filter "displayName eq 'HelpDesk Team Leaders'" | Set-EntraGroup -Description 'HelpDesk Team Leaders Global'
In dit voorbeeld ziet u hoe u een groepsbeschrijving bijwerkt.
Voorbeeld 3: Een groeps-e-mailbijnaam bijwerken
Connect-Entra -Scopes 'Group.ReadWrite.All'
$group = Get-EntraGroup -Filter "DisplayName eq 'HelpDesk Team Leaders'"
Set-EntraGroup -GroupId $group.Id -MailNickName 'newnickname'
Met deze opdracht wordt de bijnaam van de e-mail van een opgegeven groep in Microsoft Entra ID bijgewerkt.
Voorbeeld 4: Een groepsbeveiliging bijwerken ingeschakeld
Connect-Entra -Scopes 'Group.ReadWrite.All'
$group = Get-EntraGroup -Filter "DisplayName eq 'HelpDesk Team Leaders'"
Set-EntraGroup -GroupId $group.Id -SecurityEnabled $True
Met deze opdracht wordt de beveiliging bijgewerkt die is ingeschakeld voor een opgegeven groep in Microsoft Entra ID.
Voorbeeld 5: Een groepsmail bijwerken ingeschakeld
Connect-Entra -Scopes 'Group.ReadWrite.All'
$group = Get-EntraGroup -Filter "DisplayName eq 'HelpDesk Team Leaders'"
Set-EntraGroup -GroupId $group.Id -MailEnabled $False
In dit voorbeeld ziet u hoe u een groep hoofdfunctie bijwerkt.
Voorbeeld 6: Een eigenschap voor een groep bijwerken
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 dit voorbeeld ziet u hoe u een eigenschap voor een bestaande Microsoft Entra ID groep bijwerkt.
Parameters
-Description
Hiermee geeft u een beschrijving voor de groep.
Parametereigenschappen
| Type: | System.String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-DisplayName
Hiermee geeft u een weergavenaam voor de groep.
Parametereigenschappen
| Type: | System.String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-GroupId
Hiermee geeft u de object-id van een groep.
Parametereigenschappen
| Type: | System.String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Id |
Parametersets
(All)
| Position: | Named |
| Verplicht: | True |
| Waarde uit pijplijn: | True |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-GroupTypes
Hiermee geeft u op dat de groep een dynamische groep is. Als u een dynamische groep wilt maken, geeft u een waarde van DynamicMembership op.
Parametereigenschappen
| Type: | System.Collections.Generic.List`1[System.String] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-IsAssignableToRole
Deze eigenschap kan alleen worden ingesteld op het moment dat een groep wordt gemaakt en kan niet worden gewijzigd voor een bestaande groep.
Parametereigenschappen
| Type: | System.Boolean |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-MailEnabled
Geeft aan of deze groep e-mail is ingeschakeld.
Parametereigenschappen
| Type: | System.Boolean |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-MailNickname
Hiermee geeft u een bijnaam voor de e-mail voor de groep.
Parametereigenschappen
| Type: | System.String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-SecurityEnabled
Geeft aan of de groep is ingeschakeld.
Parametereigenschappen
| Type: | System.Boolean |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Visibility
Hiermee geeft u de zichtbaarheid van de inhoud en ledenlijst van de groep op. Deze parameter kan een van de volgende waarden hebben:
- 'Openbaar': iedereen kan de inhoud van de groep bekijken.
- 'Privé': alleen leden kunnen de inhoud van de groep bekijken.
- "HiddenMembership": alleen leden kunnen de inhoud van de groep bekijken en alleen leden, eigenaren, globale/bedrijfsbeheerder, gebruikersbeheerder en helpdeskbeheerders kunnen de ledenlijst van de groep bekijken.
Als er geen waarde is opgegeven, is de standaardwaarde 'Openbaar'.
Notes:
- Deze parameter is alleen geldig voor groepen waarvoor het groupType is ingesteld op Unified.
- Als voor een groep dit kenmerk is ingesteld op 'HiddenMembership', kan deze later niet meer worden gewijzigd.
- Iedereen kan deelnemen aan een groep waarvoor dit kenmerk is ingesteld op Openbaar. Als het kenmerk is ingesteld op Private of HiddenMembership, kan alleen de eigenaar nieuwe leden toevoegen aan de groep en aanvragen om lid te worden van de groep moet de eigenaar worden goedgekeurd.
Parametereigenschappen
| Type: | System.String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.