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 $nicknameCsoport 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 ACCEPTED Standard kiadás NDER tulajdonságok jegyzetei szakaszt, é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 |
-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: | AzContext, 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 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| 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: | True |
| 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 |
-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 |
-TransitiveMember
. A létrehozáshoz tekintse meg a TRANSITIVEMEMBER tulajdonságok JEGYZET 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 |
-TransitiveMemberOf
. A létrehozáshoz tekintse meg a TRANSITIVEMEMBEROF tulajdonságok 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 |
-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
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.
ACCEPTED Standard kiadás NDER <IMicrosoftGraphDirectoryObject[]>: Azon felhasználók vagy csoportok listája, amelyek a csoportban bejegyzéseket vagy naptáreseményeket hozhatnak létre. Ha ez a lista nem üres, akkor csak az itt felsorolt felhasználók vagy csoportok tehetnek közzé bejegyzéseket.
[DeletedDateTime <DateTime?>]:[DisplayName <String>]: A címtárban megjelenített név
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.
TRANSITIVEMEMBER <IMicrosoftGraphDirectoryObject[]>: .
[DeletedDateTime <DateTime?>]:[DisplayName <String>]: A címtárban megjelenített név
TRANSITIVEMEMBEROF <IMicrosoftGraphDirectoryObject[]>: .
[DeletedDateTime <DateTime?>]:[DisplayName <String>]: A címtárban megjelenített név
Visszajelzés
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ: https://aka.ms/ContentUserFeedback.
Visszajelzés küldése és megtekintése a következőhöz: