Update-AzADGroup
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
Tür: | Hashtable |
Position: | Named |
varsayılan değer: | None |
Gerekli: | 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.
Tür: | IMicrosoftGraphAppRoleAssignmentAutoGenerated[] |
Position: | Named |
varsayılan değer: | None |
Gerekli: | 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.
Tür: | String |
Position: | Named |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Cmdlet'i çalıştırmadan önce sizden onay ister.
Tür: | SwitchParameter |
Aliases: | cf |
Position: | Named |
varsayılan değer: | None |
Gerekli: | 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.
Tür: | IMicrosoftGraphDirectoryObject |
Position: | Named |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.
Tür: | PSObject |
Aliases: | AzureRMContext, AzureCredential |
Position: | Named |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeletedDateTime
.
Tür: | DateTime |
Position: | Named |
varsayılan değer: | None |
Gerekli: | 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.
Tür: | String |
Position: | Named |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisplayName
Dizinde görüntülenen ad
Tür: | String |
Position: | Named |
varsayılan değer: | None |
Gerekli: | 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.
Tür: | String[] |
Position: | Named |
varsayılan değer: | None |
Gerekli: | 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.
Tür: | SwitchParameter |
Position: | Named |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsArchived
.
Tür: | SwitchParameter |
Position: | Named |
varsayılan değer: | None |
Gerekli: | 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.
Tür: | SwitchParameter |
Position: | Named |
varsayılan değer: | None |
Gerekli: | 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.
Tür: | SwitchParameter |
Position: | Named |
varsayılan değer: | None |
Gerekli: | 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.
Tür: | String |
Position: | Named |
varsayılan değer: | None |
Gerekli: | 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.
Tür: | String |
Position: | Named |
varsayılan değer: | None |
Gerekli: | 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.
Tür: | String |
Position: | Named |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ObjectId
key: grup kimliği
Tür: | String |
Aliases: | GroupId |
Position: | Named |
varsayılan değer: | None |
Gerekli: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Komut başarılı olduğunda true döndürür
Tür: | SwitchParameter |
Position: | Named |
varsayılan değer: | None |
Gerekli: | 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.
Tür: | IMicrosoftGraphResourceSpecificPermissionGrant[] |
Position: | Named |
varsayılan değer: | None |
Gerekli: | 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.
Tür: | String |
Position: | Named |
varsayılan değer: | None |
Gerekli: | 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.
Tür: | String |
Position: | Named |
varsayılan değer: | None |
Gerekli: | 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.
Tür: | SwitchParameter |
Position: | Named |
varsayılan değer: | None |
Gerekli: | 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.
Tür: | String |
Position: | Named |
varsayılan değer: | None |
Gerekli: | 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.
Tür: | String |
Position: | Named |
varsayılan değer: | None |
Gerekli: | 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.
Tür: | String |
Position: | Named |
varsayılan değer: | None |
Gerekli: | 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.
Tür: | SwitchParameter |
Aliases: | wi |
Position: | Named |
varsayılan değer: | None |
Gerekli: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Çıkışlar
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.