New-AzureADMSGroup

  • Başvuru
Modül:
AzureAD

bir Azure AD grubu oluşturur.

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

New-AzureADMSGroup cmdlet'i bir Azure Active Directory (Azure AD) grubu oluşturur.

Örnekler

Örnek: Role atanabilir bir grup oluşturma

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

Parametreler

-Description

Grup için bir açıklama belirtir.

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

-DisplayName

Grup için bir görünen ad belirtir.

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

-GroupTypes

Grubun birleşik veya dinamik bir grup olduğunu belirtir.

Notlar:

  • Bu parametre şu anda dinamik gruplar oluşturmak için kullanılamaz. PowerShell'de dinamik grup oluşturmak için Azure AD Önizleme modülünü kullanmanız gerekir.
Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IsAssignableToRole

Grubun bir role atanıp atanamayacağını gösterir. Bu özellik yalnızca grup oluşturma sırasında ayarlanabilir ve var olan bir grupta değiştirilemez.

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

-MailEnabled

Bu grubun posta etkin olup olmadığını gösterir.

Şu anda Azure AD posta etkin gruplar oluşturamazsınız.

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

-MailNickname

Grup için bir posta takma adı belirtir. MailEnabled $False yine de bir posta takma adı belirtmeniz gerekir.

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

-SecurityEnabled

Grubun güvenlik etkin olup olmadığını gösterir. Güvenlik grupları için bu değerin $True olması gerekir.

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

-Visibility

Grubun içerik ve üye listesinin görünürlüğünü belirtir. Bu parametre aşağıdaki değerlerden birini alabilir:

  • "Genel" - Grubun içeriğini herkes görüntüleyebilir
  • "Özel" - Yalnızca üyeler grubun içeriğini görüntüleyebilir
  • "HiddenMembership" - Grubun içeriğini yalnızca üyeler görüntüleyebilir ve yalnızca üyeler, sahipler, Genel/Şirket Yöneticisi, Kullanıcı Yöneticisi ve Yardım Masası Yöneticileri grubun üye listesini görüntüleyebilir.

Hiçbir değer sağlanmazsa, varsayılan değer "Genel" olur.

Notlar:

  • Bu parametre yalnızca groupType değerinin "Unified" olarak ayarlandığı gruplar için geçerlidir.
  • Bir grupta bu öznitelik "HiddenMembership" olarak ayarlandıysa, daha sonra değiştirilemez.
  • Bu özniteliğin "Genel" olarak ayarlandığı bir gruba herkes katılabilir. Öznitelik Private veya HiddenMembership olarak ayarlanırsa, gruba yalnızca sahipler yeni üyeler ekleyebilir ve gruba katılma istekleri için sahiplerin onayı gerekir.
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Girişler

None

Çıkışlar

Object

Notlar

New-AzureADMSGroup için Microsoft Graph PowerShell'e geçiş kılavuzuna bakın.

Bu cmdlet şu anda Genel Önizleme aşamasındadır. Bir cmdlet Genel Önizleme aşamasındayken, cmdlet'te beklenmeyen etkilere neden olabilecek değişiklikler yapabiliriz. Bu cmdlet'i üretim ortamında kullanmamanızı öneririz.