Set-EntraGroup
Anger egenskaperna för en befintlig Microsoft Entra ID grupp.
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>]
Description
Cmdleten Set-EntraGroup anger egenskaperna för en befintlig Microsoft Entra ID grupp. Ange parametern GroupId för att ange egenskaperna för en befintlig Microsoft Entra ID grupp.
Exempel
Exempel 1: Uppdatera ett gruppvisningsnamn
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'
Det här kommandot uppdaterar visningsnamnet för en angiven grupp i Microsoft Entra ID.
Exempel 2: Uppdatera en gruppbeskrivning
Connect-Entra -Scopes 'Group.ReadWrite.All'
Get-EntraGroup -Filter "displayName eq 'HelpDesk Team Leaders'" | Set-EntraGroup -Description 'HelpDesk Team Leaders Global'
Det här exemplet visar hur du uppdaterar en gruppbeskrivning.
Exempel 3: Uppdatera ett smeknamn för gruppmeddelanden
Connect-Entra -Scopes 'Group.ReadWrite.All'
$group = Get-EntraGroup -Filter "DisplayName eq 'HelpDesk Team Leaders'"
Set-EntraGroup -GroupId $group.Id -MailNickName 'newnickname'
Det här kommandot uppdaterar e-postnamnet för en angiven grupp i Microsoft Entra ID.
Exempel 4: Uppdatera en gruppsäkerhet aktiverad
Connect-Entra -Scopes 'Group.ReadWrite.All'
$group = Get-EntraGroup -Filter "DisplayName eq 'HelpDesk Team Leaders'"
Set-EntraGroup -GroupId $group.Id -SecurityEnabled $True
Det här kommandot uppdaterar säkerheten som är aktiverad för en angiven grupp i Microsoft Entra ID.
Exempel 5: Uppdatera ett gruppmeddelande aktiverat
Connect-Entra -Scopes 'Group.ReadWrite.All'
$group = Get-EntraGroup -Filter "DisplayName eq 'HelpDesk Team Leaders'"
Set-EntraGroup -GroupId $group.Id -MailEnabled $False
Det här exemplet visar hur du uppdaterar en huvudgrupp aktiverad.
Exempel 6: Uppdatera en egenskap för en grupp
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
Det här exemplet visar hur du uppdaterar en egenskap för en befintlig Microsoft Entra ID grupp.
Parametrar
-Description
Anger en beskrivning för gruppen.
Parameteregenskaper
| Typ: | System.String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-DisplayName
Anger ett visningsnamn för gruppen.
Parameteregenskaper
| Typ: | System.String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-GroupId
Anger objekt-ID för en grupp.
Parameteregenskaper
| Typ: | System.String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
| Alias: | Id |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | True |
| Värde från pipeline: | True |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-GroupTypes
Anger att gruppen är en dynamisk grupp. Om du vill skapa en dynamisk grupp anger du värdet DynamicMembership.
Parameteregenskaper
| Typ: | System.Collections.Generic.List`1[System.String] |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-IsAssignableToRole
Den här egenskapen kan bara anges när gruppen skapas och kan inte ändras i en befintlig grupp.
Parameteregenskaper
| Typ: | System.Boolean |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-MailEnabled
Anger om den här gruppen är e-postaktiverad.
Parameteregenskaper
| Typ: | System.Boolean |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-MailNickname
Anger ett e-postnamn för gruppen.
Parameteregenskaper
| Typ: | System.String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-SecurityEnabled
Anger om gruppen är säkerhetsaktiverad.
Parameteregenskaper
| Typ: | System.Boolean |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Visibility
Anger synligheten för gruppens innehålls- och medlemslista. Den här parametern kan ta något av följande värden:
- "Offentlig": Vem som helst kan visa innehållet i gruppen.
- "Privat": Endast medlemmar kan visa innehållet i gruppen.
- "HiddenMembership": Endast medlemmar kan visa innehållet i gruppen och endast medlemmar, ägare, global/företagsadministratör, användaradministratör och supportadministratörer kan visa medlemslistan för gruppen.
Om inget värde anges är standardvärdet "Offentligt".
Notes:
- Den här parametern är endast giltig för grupper som har groupType inställt på "Unified".
- Om en grupp har det här attributet inställt på "HiddenMembership" kan det inte ändras senare.
- Vem som helst kan ansluta till en grupp som har det här attributet inställt på "Offentlig". Om attributet är inställt på Privat eller HiddenMembership kan endast ägaren lägga till nya medlemmar i gruppen och begäranden om att ansluta till gruppen behöver godkännande av ägaren.
Parameteregenskaper
| Typ: | System.String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.