New-AzureADMSGroup

  • Referentie
Module:
AzureAD

Hiermee maakt u een Azure AD groep.

Syntax

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 Active Directory-groep (Azure AD) 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Hiermee geeft u een weergavenaam voor de groep.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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 module Azure AD Preview gebruiken.
Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IsAssignableToRole

Geeft aan 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MailEnabled

Geeft aan of voor deze groep e-mail is ingeschakeld.

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

Type:Boolean
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SecurityEnabled

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

Type:Boolean
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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 het 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) vereisen.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

None

Uitvoerwaarden

Object

Notities

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

Deze cmdlet is 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.