Dela via

New-AzureADMSGroup

  • Referens
Modul:
AzureAD

Skapar en Azure AD-grupp.

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

Cmdleten New-AzureADMSGroup skapar en Azure Active Directory-grupp (Azure AD).

Exempel

Exempel: Skapa en grupp som kan tilldelas rollen

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

Parametrar

-Description

Anger en beskrivning av gruppen.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DisplayName

Anger ett visningsnamn för gruppen.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-GroupTypes

Anger att gruppen är en enhetlig eller dynamisk grupp.

Obs!

  • Den här parametern kan för närvarande inte användas för att skapa dynamiska grupper. Om du vill skapa en dynamisk grupp i PowerShell måste du använda Azure AD Preview-modulen.
Typ:List<T>[String]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-IsAssignableToRole

Anger om en grupp kan tilldelas till en roll. Den här egenskapen kan bara anges när gruppen skapas och kan inte ändras i en befintlig grupp.

Typ:Boolean
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-MailEnabled

Anger om den här gruppen är e-postaktiverad.

För närvarande kan du inte skapa e-postaktiverade grupper i Azure AD.

Typ:Boolean
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-MailNickname

Anger ett smeknamn för e-post för gruppen. Om MailEnabled är $False måste du fortfarande ange ett smeknamn för e-post.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SecurityEnabled

Anger om gruppen är säkerhetsaktiverad. För säkerhetsgrupper måste det här värdet vara $True.

Typ:Boolean
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Visibility

Anger synligheten för gruppens innehåll och medlemslista. Den här parametern kan ha 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ör kan visa medlemslistan i gruppen.

Om inget värde anges blir standardvärdet "Offentligt".

Obs!

  • 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å "Public". Om attributet är inställt på Privat eller HiddenMembership kan endast ägare lägga till nya medlemmar i gruppen och begäranden om att gå med i gruppen behöver godkännande av ägare.
Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

None

Utdata

Object

Kommentarer

Se migreringsguiden för New-AzureADMSGroup till Microsoft Graph PowerShell.

Den här cmdleten finns för närvarande i offentlig förhandsversion. Även om en cmdlet är i offentlig förhandsversion kan vi göra ändringar i cmdleten som kan ha oväntade effekter. Vi rekommenderar att du inte använder den här cmdleten i en produktionsmiljö.