Udostępnij za pośrednictwem

New-AzureADMSGroup

  • Odwołanie
Moduł:
AzureAD

Tworzy grupę usługi Azure AD.

Składnia

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

Opis

Polecenie cmdlet New-AzureADMSGroup tworzy grupę usługi Azure Active Directory (Azure AD).

Przykłady

Przykład: tworzenie grupy możliwej do przypisania do roli

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

Parametry

-Description

Określa opis grupy.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DisplayName

Określa nazwę wyświetlaną grupy.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-GroupTypes

Określa, że grupa jest grupą ujednoliconą lub dynamiczną.

Uwagi:

  • Obecnie nie można użyć tego parametru do tworzenia grup dynamicznych. Aby utworzyć grupę dynamiczną w programie PowerShell, należy użyć modułu Usługi Azure AD w wersji zapoznawczej.
Typ:List<T>[String]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-IsAssignableToRole

Wskazuje, czy grupę można przypisać do roli. Tę właściwość można ustawić tylko w momencie tworzenia grupy i nie można jej modyfikować w istniejącej grupie.

Typ:Boolean
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-MailEnabled

Wskazuje, czy ta grupa jest włączona.

Obecnie nie można tworzyć grup z włączoną obsługą poczty w usłudze Azure AD.

Typ:Boolean
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-MailNickname

Określa pseudonim poczty dla grupy. Jeśli mailEnabled jest $False nadal musisz określić pseudonim poczty.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SecurityEnabled

Wskazuje, czy grupa jest włączona zabezpieczeń. W przypadku grup zabezpieczeń ta wartość musi być $True.

Typ:Boolean
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Visibility

Określa widoczność zawartości grupy i listy członków. Ten parametr może przyjmować jedną z następujących wartości:

  • "Publiczne" — każda osoba może wyświetlić zawartość grupy
  • "Prywatne" — tylko członkowie mogą wyświetlać zawartość grupy
  • "HiddenMembership" — tylko członkowie mogą wyświetlać zawartość grupy i tylko członkowie, właściciele, administrator globalny/administrator firmy, administrator użytkowników i administratorzy pomocy technicznej mogą wyświetlać listę członków grupy.

Jeśli żadna wartość nie zostanie podana, wartość domyślna będzie mieć wartość "Publiczna".

Uwagi:

  • Ten parametr jest prawidłowy tylko dla grup, które mają parametr groupType ustawiony na wartość "Unified".
  • Jeśli grupa ma ten atrybut ustawiony na "HiddenMembership", nie można jej później zmienić.
  • Każdy może dołączyć do grupy, która ma ten atrybut ustawiony na "Publiczny". Jeśli atrybut jest ustawiony na Private lub HiddenMembership, tylko właściciele mogą dodawać nowych członków do grupy i żądania dołączenia do grupy wymagają zatwierdzenia właściciela.
Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

None

Dane wyjściowe

Object

Uwagi

Zobacz przewodnik migracji dla polecenia New-AzureADMSGroup do programu Microsoft Graph PowerShell.

To polecenie cmdlet jest obecnie dostępne w publicznej wersji zapoznawczej. Chociaż polecenie cmdlet jest dostępne w publicznej wersji zapoznawczej, możemy wprowadzić zmiany w poleceniu cmdlet, które może mieć nieoczekiwane skutki. Zalecamy, aby to polecenie cmdlet nie było używane w środowisku produkcyjnym.