New-AzADGroup
Új entitás hozzáadása csoportokhoz
Syntax
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
Új entitás hozzáadása csoportokhoz
Példák
1. példa: Csoport létrehozása
New-AzADGroup -DisplayName $gname -MailNickname $nickname
Csoport létrehozása
Paraméterek
-AcceptedSender
Azon felhasználók vagy csoportok listája, amelyek a csoport bejegyzéseinek vagy naptáreseményeinek létrehozására jogosultak. Ha ez a lista nem üres, akkor csak az itt felsorolt felhasználók vagy csoportok tehetnek közzé bejegyzéseket. A létrehozáshoz tekintse meg az ACCEPTEDSENDER tulajdonságok JEGYZETek szakaszát, és hozzon létre egy kivonattáblát.
Típus: | IMicrosoftGraphDirectoryObject[] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-AdditionalProperties
További paraméterek
Típus: | Hashtable |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | IMicrosoftGraphAppRoleAssignmentAutoGenerated[] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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).
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Confirm
Jóváhagyást kér a parancsmag futtatása előtt.
Típus: | SwitchParameter |
Aliasok: | cf |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | IMicrosoftGraphDirectoryObject |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-DefaultProfile
Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.
Típus: | PSObject |
Aliasok: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-DeletedDateTime
.
Típus: | DateTime |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-DisplayName
A csoport megjelenítendő neve. Ez a tulajdonság egy csoport létrehozásakor szükséges, és a frissítések során nem törölhető. Alapértelmezés szerint visszaadva. Támogatja a $filter (eq, ne, NOT, ge, le, in, startsWith), $search és $orderBy.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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).
Típus: | String[] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-IsArchived
.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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).
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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).
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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).
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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).
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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).
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | IMicrosoftGraphResourceSpecificPermissionGrant[] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-PreferredDataLocation
A csoport elsődleges adathelye. További információ: OneDrive Online Multi-Geo. Alapértelmezés szerint visszaadva.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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).
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-SecurityEnabled
Megadja, hogy a csoport biztonsági csoport-e. Alapértelmezés szerint visszaadva. Támogatja a $filter (eq, ne, NOT, in).
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-SecurityIdentifier
A windowsos forgatókönyvekben használt csoport biztonsági azonosítója. Alapértelmezés szerint visszaadva.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-TransitiveMember
. A létrehozáshoz tekintse meg a TRANSITIVEMEMBER tulajdonságok JEGYZET szakaszát, és hozzon létre egy kivonattáblát.
Típus: | IMicrosoftGraphDirectoryObject[] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-TransitiveMemberOf
. A létrehozáshoz tekintse meg a TRANSITIVEMEMBEROF tulajdonságok JEGYZETek szakaszát, és hozzon létre egy kivonattáblát.
Típus: | IMicrosoftGraphDirectoryObject[] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-WhatIf
Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.
Típus: | SwitchParameter |
Aliasok: | wi |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |