New-AzureADMSGroup

  • Referenz
Modul:
AzureAD

Erstellt eine Azure AD-Gruppe.

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>]

Beschreibung

Das Cmdlet New-AzureADMSGroup erstellt eine Azure Active Directory-Gruppe (Azure AD).

Beispiele

Beispiel: Erstellen einer Gruppe, die der Rolle zugewiesen werden kann

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                    : {}

Parameter

-Description

Gibt eine Beschreibung für die Gruppe an.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Gibt einen Anzeigenamen für die Gruppe an.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-GroupTypes

Gibt an, dass es sich bei der Gruppe um eine einheitliche oder dynamische Gruppe handelt.

Hinweise:

  • Dieser Parameter kann derzeit nicht zum Erstellen dynamischer Gruppen verwendet werden. Zum Erstellen einer dynamischen Gruppe in PowerShell müssen Sie das Azure AD Preview-Modul verwenden.
Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IsAssignableToRole

Gibt an, ob eine Gruppe einer Rolle zugewiesen werden kann. Diese Eigenschaft kann nur zum Zeitpunkt der Gruppenerstellung festgelegt werden und kann nicht für eine vorhandene Gruppe geändert werden.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MailEnabled

Gibt an, ob diese Gruppe E-Mail aktiviert ist.

Derzeit können Sie keine E-Mail-aktivierten Gruppen in Azure AD erstellen.

Type:Boolean
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-MailNickname

Gibt einen E-Mail-Nicknamen für die Gruppe an. Wenn MailEnabled $False müssen Sie trotzdem einen E-Mail-Spitznamen angeben.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SecurityEnabled

Gibt an, ob die Gruppe sicherheitsaktiv ist. Für Sicherheitsgruppen muss dieser Wert $True sein.

Type:Boolean
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Visibility

Gibt die Sichtbarkeit des Inhalts und der 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 Helpdeskadministratoren können die Mitgliederliste der Gruppe anzeigen.

Wenn kein Wert angegeben wird, lautet der Standardwert "Öffentlich".

Hinweise:

  • Dieser Parameter ist nur für Gruppen gültig, für die groupType auf "Unified" festgelegt ist.
  • Wenn für eine Gruppe dieses Attribut auf "HiddenMembership" festgelegt ist, kann es später nicht mehr geändert werden.
  • Jeder kann einer Gruppe beitreten, deren Attribut auf "Öffentlich" festgelegt ist. Wenn das Attribut auf Privat oder HiddenMembership festgelegt ist, können nur Besitzer der Gruppe neue Mitglieder hinzufügen, und Anforderungen zum Beitritt zur Gruppe müssen von den Besitzern genehmigt werden.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

None

Ausgaben

Object

Hinweise

Weitere Informationen finden Sie im Migrationsleitfaden für New-AzureADMSGroup zu Microsoft Graph PowerShell.

Dieses Cmdlet befindet sich derzeit in der öffentlichen Vorschau. Während sich ein Cmdlet in der öffentlichen Vorschau befindet, nehmen wir möglicherweise Änderungen am Cmdlet vor, die unerwartete Auswirkungen haben können. Es wird empfohlen, dieses Cmdlet nicht in einer Produktionsumgebung zu verwenden.