Delen via

New-AzureADMSGroup

  • Referentie
Module:
AzureAD

Hiermee maakt u een Azure AD-groep.

Syntaxis

New-AzureADMSGroup
   [-Description <String>]
   -DisplayName <String>
   [-IsAssignableToRole <Boolean>]
   -MailEnabled <Boolean>
   -MailNickname <String>
   -SecurityEnabled <Boolean>
   [-GroupTypes <System.Collections.Generic.List`1[System.String]>]
   [-Visibility <String>]
   [<CommonParameters>]

Description

Met de cmdlet New-AzureADMSGroup wordt een Azure Ad-groep (Azure Active Directory) gemaakt.

Voorbeelden

Voorbeeld: Een groep maken die kan worden toegewezen aan een rol

PS C:\> New-AzureADMSGroup -DisplayName "HelpDesk admin group" -Description "Group assignable to role" -MailEnabled $False -MailNickname "helpDeskAdminGroup" -SecurityEnabled $True -IsAssignableToRole $True -Visibility "Private"

Id                            : 1026185e-25df-4522-a380-7ab697a7241c
Description                   : Group assignable to role
OnPremisesSyncEnabled         : 
DisplayName                   : HelpDesk admin group
Mail                          : 
MailEnabled                   : False
IsAssignableToRole            : True 
MailNickname                  : helpDeskAdminGroup
ProxyAddresses                : {} 
SecurityEnabled               : True 
GroupTypes                    : {}

Parameters

-Description

Hiermee geeft u een beschrijving voor de groep.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DisplayName

Hiermee geeft u een weergavenaam voor de groep.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-GroupTypes

Hiermee geeft u op dat de groep een geïntegreerde of dynamische groep is.

Opmerkingen:

  • Deze parameter kan momenteel niet worden gebruikt om dynamische groepen te maken. Als u een dynamische groep wilt maken in PowerShell, moet u de Azure AD Preview-module gebruiken.
Type:List<T>[String]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-IsAssignableToRole

Hiermee wordt aangegeven of een groep kan worden toegewezen aan een rol. Deze eigenschap kan alleen worden ingesteld op het moment dat de groep wordt gemaakt en kan niet worden gewijzigd voor een bestaande groep.

Type:Boolean
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-MailEnabled

Hiermee wordt aangegeven of e-mail is ingeschakeld voor deze groep.

Op dit moment kunt u geen groepen met e-mail maken in Azure AD.

Type:Boolean
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-MailNickname

Hiermee geeft u een e-mailbijnaam voor de groep. Als MailEnabled is $False moet u nog steeds een e-mailnaam opgeven.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SecurityEnabled

Hiermee wordt aangegeven of beveiliging voor de groep is ingeschakeld. Voor beveiligingsgroepen moet deze waarde $True zijn.

Type:Boolean
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren: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 wordt opgegeven, is de standaardwaarde 'Openbaar'.

Opmerkingen:

  • Deze parameter is alleen geldig voor groepen waarvoor groupType is ingesteld op 'Unified'.
  • Als dit kenmerk voor een groep is ingesteld op 'HiddenMembership', kan dit 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, kunnen alleen eigenaar(s) nieuwe leden toevoegen aan de groep en moeten aanvragen om lid te worden van de groep goedkeuring van de eigenaar(s).
Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

None

Uitvoerwaarden

Object

Notities

Zie de migratiehandleiding voor New-AzureADMSGroup naar Microsoft Graph PowerShell.

Deze cmdlet bevindt zich momenteel in openbare preview. Terwijl een cmdlet zich in openbare preview bevindt, kunnen we wijzigingen aanbrengen in de cmdlet die onverwachte gevolgen kunnen hebben. We raden u aan deze cmdlet niet te gebruiken in een productieomgeving.