Aracılığıyla paylaş


Update-AzADGroup

gruplarda varlığı güncelleştirme

Sözdizimi

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>]
Update-AzADGroup
      -ObjectId <String>
      -JsonFilePath <String>
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzADGroup
      -ObjectId <String>
      -JsonString <String>
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

gruplarda 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

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.

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.

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

-DefaultProfile

DefaultProfile parametresi işlevsel değil. Cmdlet'i farklı bir abonelikte yürütürken kullanılabilir olduğunda SubscriptionId parametresini kullanın.

Tür:PSObject
Diğer adlar: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

Dizinde görüntülenen ad

Tür:String
Position:Named
Default value:None
Gerekli:False
İş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

-JsonFilePath

Güncelleştirme işlemine sağlanan Json dosyasının yolu

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

-JsonString

Güncelleştirme işlemine sağlanan Json dizesi

Tür:String
Position:Named
Default value:None
Gerekli:True
İş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: @()/[]';: içinde kullanılamaz.<>, ARA ÇUBUĞU. 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

-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

-ObjectId

key: grup kimliği

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

-PassThru

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

Tür:SwitchParameter
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.

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

-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ırsa 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

Boolean