Update-AzADGroup

Entitás frissítése csoportokban

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

Entitás frissítése csoportokban

Példák

1. példa: A csoport frissítési leírása

Update-AzADGroup -ObjectId $objectid -Description $description

A csoport frissítési leírása.

Paraméterek

-AdditionalProperties

További paraméterek

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

-AppRoleAssignment

Azt az alkalmazásszerepkört jelöli, amelyet egy csoport adott egy alkalmazáshoz. Támogatja a $expand. A létrehozáshoz tekintse meg az APPROLEASSIGNMENT tulajdonságok JEGYZETek szakaszát, és hozzon létre egy kivonattáblát.

Type:IMicrosoftGraphAppRoleAssignmentAutoGenerated[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Classification

A csoport besorolását ismerteti (például alacsony, közepes vagy magas üzleti hatás). A tulajdonság érvényes értékeit egy ClassificationList beállítási érték létrehozásával definiálja a sablondefiníció alapján. Alapértelmezés szerint visszaadva. Támogatja a $filter (eq, ne, NOT, ge, le, startsWith).

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

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

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

-CreatedOnBehalfOf

Egy Azure Active Directory-objektumot jelöl. A directoryObject típus számos más címtár-entitástípus alaptípusa. A létrehozáshoz tekintse meg a CREATEDONBEHALFOF tulajdonságainak JEGYZETEK szakaszát, és hozzon létre egy kivonattáblát.

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

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.

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

A csoport opcionális leírása. Alapértelmezés szerint visszaadva. Támogatja $filter (eq, ne, NOT, ge, le, startsWith) és $search.

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

-DisplayName

A címtárban megjelenített név

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

-GroupType

Megadja a csoport típusát és tagságát. Ha a gyűjtemény egyesítettt tartalmaz, a csoport Egy Microsoft 365-csoport; ellenkező esetben biztonsági csoport vagy terjesztési csoport. Részletekért tekintse meg a csoportok áttekintését. Ha a gyűjtemény dinamikus tagolást tartalmaz, a csoport dinamikus tagsággal rendelkezik; ellenkező esetben a tagság statikus. Alapértelmezés szerint visszaadva. Támogatja a $filter (eq, NOT).

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

-HasMembersWithLicenseError

Azt jelzi, hogy vannak-e olyan tagok ebben a csoportban, akiknek licenchibái vannak a csoportalapú licenckiosztásban. Ez a tulajdonság soha nem lesz visszaadva GET művelet esetén. Ezt használhatja $filter argumentumként olyan csoportok lekéréséhez, amelyekben licenchiba lépett fel (azaz szűrje, hogy ez a tulajdonság igaz-e). Támogatja a $filter (eq) használatát.

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

Azt jelzi, hogy ez a csoport hozzárendelhető-e egy Azure Active Directory-szerepkörhöz. Ez a tulajdonság csak a csoport létrehozásakor állítható be, és nem módosítható. Ha igaz értékre van állítva, a securityEnabled tulajdonságot is igaz értékre kell állítani, és a csoport nem lehet dinamikus csoport (vagyis a groupTypes nem tartalmazhat DynamicMembership értéket). Ezt a tulajdonságot csak a globális rendszergazdai és emelt szintű szerepkör-rendszergazdai szerepkörök hívói állíthatják be. A hívónak hozzá kell rendelnie a Directory.AccessAsUser.All engedélyt a tulajdonság beállításához. További információ: Az Azure AD-szerepkör-hozzárendelések kezelése Csoport használata Alapértelmezés szerint be van állítva. Támogatja a $filter (eq, ne, NOT).

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

-MailEnabled

Megadja, hogy a csoport engedélyezve van-e a levelezéshez. Alapértelmezés szerint visszaadva. Támogatja a $filter (eq, ne, NOT).

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

-MailNickname

A csoport levelezési aliasa, amely a szervezetben egyedi. Ezt a tulajdonságot egy csoport létrehozásakor kell megadni. Ezek a karakterek nem használhatók a mailNickName: @()/[]';:.<>,SPACE fájlban. Alapértelmezés szerint visszaadva. Támogatja a $filter (eq, ne, NOT, ge, le, in, startsWith).

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

-MembershipRule

A csoport tagjait meghatározó szabály, ha a csoport dinamikus csoport (a groupTypes a DynamicMembership-et tartalmazza). A tagsági szabály szintaxisával kapcsolatos további információkért lásd: Tagsági szabályok szintaxisa. Alapértelmezés szerint visszaadva. Támogatja a $filter (eq, ne, NOT, ge, le, startsWith).

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

-MembershipRuleProcessingState

Azt jelzi, hogy a dinamikus tagság feldolgozása be van-e kapcsolva vagy szüneteltetve. A lehetséges értékek be vannak kapcsolva vagy szüneteltetve. Alapértelmezés szerint visszaadva. Támogatja a $filter (eq, ne, NOT, in).

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

-ObjectId

kulcs: csoport azonosítója

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

-PassThru

Igaz értéket ad vissza, ha a parancs sikeres

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

-PermissionGrant

Az adott alkalmazásnak adott csoporthoz adott engedélyek. Támogatja a $expand. A létrehozáshoz tekintse meg a PERMISSIONGRANT tulajdonságok JEGYZETek szakaszát, és hozzon létre egy kivonattáblát.

Type:IMicrosoftGraphResourceSpecificPermissionGrant[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PreferredDataLocation

A csoport elsődleges adathelye. További információ: OneDrive Online Multi-Geo. Alapértelmezés szerint visszaadva.

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

-PreferredLanguage

A Microsoft 365-csoportok által előnyben részesített nyelv. Az ISO 639-1-kódot kell követnie; például "en-US". Alapértelmezés szerint visszaadva. Támogatja a $filter (eq, ne, NOT, ge, le, in, startsWith).

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

-SecurityEnabled

Megadja, hogy a csoport biztonsági csoport-e. Alapértelmezés szerint visszaadva. Támogatja a $filter (eq, ne, NOT, in).

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

-SecurityIdentifier

A windowsos forgatókönyvekben használt csoport biztonsági azonosítója. Alapértelmezés szerint visszaadva.

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

-Theme

A Microsoft 365-csoport színtémája. A lehetséges értékek a réva, a lila, a zöld, a kék, a rózsaszín, a narancssárga vagy a piros. Alapértelmezés szerint visszaadva.

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

-Visibility

Meghatározza a csoportokhoz való csatlakozás szabályzatát és a csoportok tartalom láthatóságát. A lehetséges értékek a következők: Privát, Nyilvános vagy Hiddenmembership. A Hiddenmembership csak Microsoft 365-csoportokhoz állítható be a csoportok létrehozásakor. Később nem frissíthető. A csoportlétrehozás után más láthatósági értékek is frissíthetők. Ha a Microsoft Graphon a csoportlétrehozás során nincs megadva láthatósági érték, a rendszer alapértelmezés szerint privátként hoz létre egy biztonsági csoportot, a Microsoft 365-csoport pedig nyilvános. További információért tekintse meg a csoport láthatósági beállításait. Alapértelmezés szerint visszaadva.

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

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

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

Kimenetek

Boolean

Jegyzetek

ALIASOK

ÖSSZETETT PARAMÉTERTULAJDONSÁGOK

Az alábbiakban ismertetett paraméterek létrehozásához hozzon létre egy kivonattáblát, amely tartalmazza a megfelelő tulajdonságokat. A kivonattáblákra vonatkozó információkért futtassa a Get-Help about_Hash_Tables.

APPROLEASSIGNMENT <IMicrosoftGraphAppRoleAssignmentAutoGenerated[]>: Azt az alkalmazásszerepkört jelöli, amelyet egy csoport adott egy alkalmazáshoz. Támogatja a $expand.

  • [DeletedDateTime <DateTime?>]:
  • [DisplayName <String>]: A címtárban megjelenített név
  • [AppRoleId <String>]: Az egyszerű felhasználóhoz rendelt alkalmazásszerepkör azonosítója (azonosítója). Ezt az alkalmazásszerepkört közzé kell tenni az erőforrásalkalmazás szolgáltatásnévén (resourceId) található AppRoles tulajdonságban. Ha az erőforrásalkalmazás nem deklarált semmilyen alkalmazásszerepkört, az alapértelmezett alkalmazásszerepkör-azonosító 000000000-0000-0000-00000000000 lehet annak jelzésére, hogy az egyszerű erőforrás-szerepkör meghatározott alkalmazásszerepkörök nélkül van hozzárendelve az erőforrásalkalmazáshoz. Létrehozáshoz szükséges.
  • [CreatedDateTime <DateTime?>]: Az alkalmazásszerepkör-hozzárendelés létrehozásának időpontja. Az időbélyeg típusa az ISO 8601 formátumot használó dátum- és időadatokat jelöli, és mindig UTC idő szerint van megadva. A 2014. január 1-jén éjféli UTC például 2014-01-01T00:00:00Z. Írásvédett.
  • [PrincipalDisplayName <String>]: Annak a felhasználónak, csoportnak vagy szolgáltatásnévnek a megjelenítendő neve, aki megkapta az alkalmazásszerepkör-hozzárendelést. Írásvédett. Támogatja a $filter (eq és startswith).
  • [PrincipalId <String>]: Az alkalmazásszerepkört kapó felhasználó, csoport vagy szolgáltatásnév egyedi azonosítója (azonosítója). Létrehozáshoz szükséges.
  • [PrincipalType <String>]: A hozzárendelt tag típusa. Ez lehet felhasználó, csoport vagy ServicePrincipal. Írásvédett.
  • [ResourceDisplayName <String>]: Annak az erőforrásalkalmazásnak a szolgáltatásnévnek a megjelenítendő neve, amelyhez a hozzárendelést végrehajtották.
  • [ResourceId <String>]: Annak az erőforrás-szolgáltatásnévnek az egyedi azonosítója (azonosítója), amelyhez a hozzárendelést végrehajtották. Létrehozáshoz szükséges. Támogatja a $filter (csak eq).

CREATEDONBEHALFOF <IMicrosoftGraphDirectoryObject>: Egy Azure Active Directory-objektumot jelöl. A directoryObject típus számos más címtár-entitástípus alaptípusa.

  • [DeletedDateTime <DateTime?>]:
  • [DisplayName <String>]: A címtárban megjelenített név

PERMISSIONGRANT <IMicrosoftGraphResourceSpecificPermissionGrant[]>: Az adott alkalmazáshoz adott csoporthoz megadott engedélyek. Támogatja a $expand.

  • [DeletedDateTime <DateTime?>]:
  • [DisplayName <String>]: A címtárban megjelenített név
  • [ClientAppId <String>]: A hozzáféréssel rendelkező Azure AD-alkalmazás szolgáltatásnévének azonosítója. Írásvédett.
  • [ClientId <String>]: A hozzáféréssel rendelkező Azure AD-alkalmazás azonosítója. Írásvédett.
  • [Permission <String>]: Az erőforrás-specifikus engedély neve. Írásvédett.
  • [PermissionType <String>]: Az engedély típusa. Lehetséges értékek: Alkalmazás, Delegált. Írásvédett.
  • [ResourceAppId <String>]: Az erőforrást üzemeltető Azure AD-alkalmazás azonosítója. Írásvédett.