Aracılığıyla paylaş


New-AzADGroup

Gruplara yeni varlık ekler

Sözdizimi

New-AzADGroup
   -DisplayName <String>
   -MailNickname <String>
   [-AcceptedSender <IMicrosoftGraphDirectoryObject[]>]
   [-AdditionalProperties <Hashtable>]
   [-AppRoleAssignment <IMicrosoftGraphAppRoleAssignmentAutoGenerated[]>]
   [-Classification <String>]
   [-CreatedOnBehalfOf <IMicrosoftGraphDirectoryObject>]
   [-DeletedDateTime <DateTime>]
   [-Description <String>]
   [-GroupType <String[]>]
   [-HasMembersWithLicenseError]
   [-IsArchived]
   [-IsAssignableToRole]
   [-MailEnabled]
   [-MembershipRule <String>]
   [-MembershipRuleProcessingState <String>]
   [-PermissionGrant <IMicrosoftGraphResourceSpecificPermissionGrant[]>]
   [-PreferredDataLocation <String>]
   [-PreferredLanguage <String>]
   [-SecurityEnabled]
   [-SecurityIdentifier <String>]
   [-Theme <String>]
   [-TransitiveMember <IMicrosoftGraphDirectoryObject[]>]
   [-TransitiveMemberOf <IMicrosoftGraphDirectoryObject[]>]
   [-Visibility <String>]
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Gruplara yeni varlık ekler

Örnekler

Örnek 1: Grup oluşturma

New-AzADGroup -DisplayName $gname -MailNickname $nickname

Grup oluştur

Parametreler

-AcceptedSender

Bu grupta gönderi veya takvim olayları oluşturmasına izin verilen kullanıcı veya grupların listesi. Bu liste boş değilse yalnızca burada listelenen kullanıcıların veya grupların gönderi göndermesine izin verilir. Oluşturmak için ACCEPTEDSENDER özellikleri için NOTES bölümüne bakın ve bir karma tablo oluşturun.

Tür:IMicrosoftGraphDirectoryObject[]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-AdditionalProperties

Ek Parametreler

Tür:Hashtable
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-AppRoleAssignment

Bir uygulama için bir gruba verilen uygulama rollerini temsil eder. $expand destekler. Oluşturmak için APPROLEASSIGNMENT özellikleri için NOTES bölümüne bakın ve bir karma tablo oluşturun.

Tür:IMicrosoftGraphAppRoleAssignmentAutoGenerated[]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Classification

Grup için bir sınıflandırmayı açıklar (örneğin, düşük, orta veya yüksek iş etkisi). Bu özellik için geçerli değerler, şablon tanımına göre bir ClassificationList ayar değeri oluşturularak tanımlanır. Varsayılan olarak döndürülür. $filter (eq, ne, NOT, ge, le, startsWith) destekler.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tür:SwitchParameter
Diğer adlar:cf
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-CreatedOnBehalfOf

Azure Active Directory nesnesini temsil eder. directoryObject türü, diğer birçok dizin varlık türünün temel türüdür. Oluşturmak için CREATEDONBEHALFOF özellikleri için NOTES bölümüne bakın ve bir karma tablo oluşturun.

Tür:IMicrosoftGraphDirectoryObject
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.

Tür:PSObject
Diğer adlar:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DeletedDateTime

.

Tür:DateTime
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Description

Grup için isteğe bağlı bir açıklama. Varsayılan olarak döndürülür. $filter (eq, ne, NOT, ge, le, startsWith) ve $search destekler.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DisplayName

Grubun görünen adı. Bu özellik, bir grup oluşturulduğunda gereklidir ve güncelleştirmeler sırasında temizlenemez. Varsayılan olarak döndürülür. $filter (eq, ne, NOT, ge, le, in, startsWith), $search ve $orderBy destekler.

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-GroupType

Grup türünü ve üyeliğini belirtir. Koleksiyon Birleşik içeriyorsa, grup bir Microsoft 365 grubudur; aksi takdirde, bir güvenlik grubu veya dağıtım grubu olur. Ayrıntılar için bkz. Gruplara genel bakış. Koleksiyon DynamicMembership içeriyorsa grubun dinamik üyeliği vardır; aksi takdirde üyelik statiktir. Varsayılan olarak döndürülür. $filter (eq, NOT) destekler.

Tür:String[]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-HasMembersWithLicenseError

Bu grupta, grup tabanlı lisans atamasından lisans hataları olan üyeler olup olmadığını gösterir. Bu özellik hiçbir zaman get işleminde döndürülemez. Lisans hataları olan üyeleri olan grupları (yani, bu özelliğin true olması için filtre uygulamak) almak için bunu $filter bağımsız değişkeni olarak kullanabilirsiniz. $filter (eq) destekler.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-IsArchived

.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-IsAssignableToRole

Bu grubun bir Azure Active Directory rolüne atanıp atanamayacağını gösterir. Bu özellik yalnızca grup oluşturulurken ayarlanabilir ve sabittir. true olarak ayarlanırsa securityEnabled özelliği de true olarak ayarlanmalıdır ve grup dinamik bir grup olamaz (yani, groupType'lar DynamicMembership içeremez). Bu özelliği yalnızca Genel yönetici ve Ayrıcalıklı rol yöneticisi rollerindeki arayanlar ayarlayabilir. Çağıranın bu özelliği ayarlaması için Directory.AccessAsUser.All izni de atanmalıdır. Daha fazla bilgi için bkz. Azure AD rol atamalarını yönetmek için grup kullanma Varsayılan olarak yeniden başlatma. $filter (eq, ne, NOT) destekler.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-MailEnabled

Grubun posta etkin olup olmadığını belirtir. Varsayılan olarak döndürülür. $filter (eq, ne, NOT) destekler.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-MailNickname

Grubun posta diğer adı, kuruluşta benzersizdir. Bir grup oluşturulduğunda bu özellik belirtilmelidir. Bu karakterler mailNickName: @()/[]';:.<>,SPACE içinde kullanılamaz. Varsayılan olarak döndürülür. $filter (eq, ne, NOT, ge, le, in, startsWith) destekler.

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-MembershipRule

Grup dinamik bir grupsa bu grubun üyelerini belirleyen kural (groupTypes, DynamicMembership içerir). Üyelik kuralının söz dizimi hakkında daha fazla bilgi için bkz. Üyelik Kuralları söz dizimi. Varsayılan olarak döndürülür. $filter (eq, ne, NOT, ge, le, startsWith) destekler.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-MembershipRuleProcessingState

Dinamik üyelik işleminin açık mı yoksa duraklatılmış mı olduğunu gösterir. Olası değerler Açık veya Duraklatıldı şeklindedir. Varsayılan olarak döndürülür. $filter (eq, ne, NOT, in) destekler.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-PermissionGrant

Belirli bir uygulamaya bir grup için verilen izinler. $expand destekler. Oluşturmak için PERMISSIONGRANT özellikleri için NOTES bölümüne bakın ve bir karma tablo oluşturun.

Tür:IMicrosoftGraphResourceSpecificPermissionGrant[]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-PreferredDataLocation

Grup için tercih edilen veri konumu. Daha fazla bilgi için bkz. OneDrive Online Multi-Geo. Varsayılan olarak döndürülür.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-PreferredLanguage

Microsoft 365 grubu için tercih edilen dil. ISO 639-1 Koduna uygun olmalıdır; örneğin ,'en-US'. Varsayılan olarak döndürülür. $filter (eq, ne, NOT, ge, le, in, startsWith) destekler.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-SecurityEnabled

Grubun bir güvenlik grubu olup olmadığını belirtir. Varsayılan olarak döndürülür. $filter (eq, ne, NOT, in) destekler.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-SecurityIdentifier

Windows senaryolarında kullanılan grubun güvenlik tanımlayıcısı. Varsayılan olarak döndürülür.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Theme

Microsoft 365 grubunun renk temasını belirtir. Olası değerler Teal, Mor, Yeşil, Mavi, Pembe, Turuncu veya Kırmızı'dır. Varsayılan olarak döndürülür.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-TransitiveMember

. Oluşturmak için, TRANSITIVEMEMBER özellikleri için NOTES bölümüne bakın ve bir karma tablo oluşturun.

Tür:IMicrosoftGraphDirectoryObject[]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-TransitiveMemberOf

. Oluşturmak için TRANSITIVEMEMBEROF özellikleri için NOTES bölümüne bakın ve bir karma tablo oluşturun.

Tür:IMicrosoftGraphDirectoryObject[]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Visibility

Gruplar için grup birleştirme ilkesini ve grup içeriği görünürlüğünü belirtir. Olası değerler şunlardır: Private, Public veya Hiddenmembership. Hiddenmembership yalnızca gruplar oluşturulduğunda Microsoft 365 grupları için ayarlanabilir. Daha sonra güncelleştirilemez. Diğer görünürlük değerleri grup oluşturulduktan sonra güncelleştirilebilir. Microsoft Graph'ta grup oluşturma sırasında görünürlük değeri belirtilmezse, varsayılan olarak Özel olarak bir güvenlik grubu oluşturulur ve Microsoft 365 grubu Genel'dir. Daha fazla bilgi edinmek için bkz. grup görünürlüğü seçenekleri. Varsayılan olarak döndürülür.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Tür:SwitchParameter
Diğer adlar:wi
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Çıkışlar

IMicrosoftGraphGroup

Notlar

TAKMA

KARMAŞıK PARAMETRE ÖZELLIKLERI

Aşağıda açıklanan parametreleri oluşturmak için uygun özellikleri içeren bir karma tablo oluşturun. Karma tablolar hakkında bilgi için Get-Help about_Hash_Tables komutunu çalıştırın.

ACCEPTEDSENDER <IMicrosoftGraphDirectoryObject[]>: Bu grupta gönderi veya takvim olayları oluşturmasına izin verilen kullanıcı veya grupların listesi. Bu liste boş değilse yalnızca burada listelenen kullanıcıların veya grupların gönderi göndermesine izin verilir.

  • [DeletedDateTime <DateTime?>]:
  • [DisplayName <String>]: Dizinde görüntülenen ad

APPROLEASSIGNMENT <IMicrosoftGraphAppRoleAssignmentAutoGenerated[]>: Bir gruba uygulama için verilmiş olan uygulama rollerini temsil eder. $expand destekler.

  • [DeletedDateTime <DateTime?>]:
  • [DisplayName <String>]: Dizinde görüntülenen ad
  • [AppRoleId <String>]: Sorumluya atanan uygulama rolünün tanımlayıcısı (id). Bu uygulama rolü, kaynak uygulamanın hizmet sorumlusundaki (resourceId) appRoles özelliğinde gösterilmelidir. Kaynak uygulama herhangi bir uygulama rolü belirtmediyse, sorumlunun belirli bir uygulama rolü olmadan kaynak uygulamasına atandığını belirten bir varsayılan uygulama rolü kimliği 00000000-0000-0000-0000000000 olarak belirtilebilir. Oluşturmada gereklidir.
  • [CreatedDateTime <DateTime?>]: Uygulama rolü atamasının oluşturulduğu saat. Zaman damgası türü, ISO 8601 biçimini kullanan tarih ve saat bilgilerini temsil eder ve her zaman UTC saatindedir. Örneğin, 1 Ocak 2014'te utc gece yarısı 2014-01-01T00:00:00Z şeklindedir. Salt okunur.
  • [PrincipalDisplayName <String>]: Uygulama rolü ataması verilen kullanıcı, grup veya hizmet sorumlusunun görünen adı. Salt okunur. $filter (eq ve startswith) destekler.
  • [PrincipalId <String>]: Uygulama rolü verilen kullanıcı, grup veya hizmet sorumlusu için benzersiz tanımlayıcı (kimlik). Oluşturmada gereklidir.
  • [PrincipalType <String>]: Atanan sorumlunun türü. Bu Kullanıcı, Grup veya ServicePrincipal olabilir. Salt okunur.
  • [ResourceDisplayName <String>]: Atamanın yapıldığı kaynak uygulamasının hizmet sorumlusunun görünen adı.
  • [ResourceId <String>]: Atamanın yapıldığı kaynak hizmet sorumlusunun benzersiz tanımlayıcısı (kimlik). Oluşturmada gereklidir. $filter destekler (yalnızca eq).

CREATEDONBEHALFOF <IMicrosoftGraphDirectoryObject>: Azure Active Directory nesnesini temsil eder. directoryObject türü, diğer birçok dizin varlık türünün temel türüdür.

  • [DeletedDateTime <DateTime?>]:
  • [DisplayName <String>]: Dizinde görüntülenen ad

PERMISSIONGRANT <IMicrosoftGraphResourceSpecificPermissionGrant[]>: Belirli bir uygulamaya bir grup için verilen izinler. $expand destekler.

  • [DeletedDateTime <DateTime?>]:
  • [DisplayName <String>]: Dizinde görüntülenen ad
  • [ClientAppId <String>]: Erişim verilen Azure AD uygulamasının hizmet sorumlusunun kimliği. Salt okunur.
  • [ClientId <String>]: Erişim verilen Azure AD uygulamasının kimliği. Salt okunur.
  • [Permission <String>]: Kaynağa özgü iznin adı. Salt okunur.
  • [PermissionType <String>]: İzin türü. Olası değerler şunlardır: Uygulama, Temsilci. Salt okunur.
  • [ResourceAppId <String>]: Kaynağı barındıran Azure AD uygulamasının kimliği. Salt okunur.

TRANSITIVEMEMBER <IMicrosoftGraphDirectoryObject[]>: .

  • [DeletedDateTime <DateTime?>]:
  • [DisplayName <String>]: Dizinde görüntülenen ad

TRANSITIVEMEMBEROF <IMicrosoftGraphDirectoryObject[]>: .

  • [DeletedDateTime <DateTime?>]:
  • [DisplayName <String>]: Dizinde görüntülenen ad