Update-AzADGroup

  • Başvuru
Modül:
Az.Resources

Gruplardaki varlığı güncelleştirme

Syntax

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

Description

Gruplardaki varlığı güncelleştirme

Örnekler

Örnek 1: Grup için güncelleştirme açıklaması

Update-AzADGroup -ObjectId $objectid -Description $description

Grup için güncelleştirme açıklaması.

Parametreler

-AdditionalProperties

Ek Parametreler

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:IMicrosoftGraphAppRoleAssignmentAutoGenerated[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-DefaultProfile

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

Type:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeletedDateTime

.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-DisplayName

Dizinde görüntülenen ad

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-IsArchived

.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-MailEnabled

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-ObjectId

key: grup kimliği

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

-PassThru

Komut başarılı olduğunda true döndürür

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:IMicrosoftGraphResourceSpecificPermissionGrant[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-SecurityIdentifier

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Çıkışlar

Boolean

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.

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.