Get-EntraGroup

Modul:: Microsoft.Entra.Groups Module v1.3

Beolvas egy csoportot.

Syntax

GetQuery (Alapértelmezett)

Get-EntraGroup

    [-Top <Int32>]
    [-All]
    [-Filter <String>]
    [-Property <String[]>]
    [-HasErrorsOnly]
    [-HasLicenseErrorsOnly]
    [<CommonParameters>]

GetVague

Get-EntraGroup

    [-SearchString <String>]
    [-All]
    [-Property <String[]>]
    [-HasErrorsOnly]
    [-HasLicenseErrorsOnly]
    [<CommonParameters>]

GetById

Get-EntraGroup

    -GroupId <String>
    [-All]
    [-Property <String[]>]
    [<CommonParameters>]

Append

Get-EntraGroup

    -Property <String[]>
    -AppendSelected
    [-GroupId <String>]
    [-Top <Int32>]
    [-All]
    [-Filter <String>]
    [-SearchString <String>]
    [-HasErrorsOnly]
    [-HasLicenseErrorsOnly]
    [<CommonParameters>]

Description

A Get-EntraGroup parancsmag beolvas egy csoportot Microsoft Entra ID. Adja meg a ObjectId paramétert egy adott csoport lekéréséhez.

Az eredmények szűrésével csak a problémás csoportokat jelenítheti meg a HasErrorsOnly paraméterrel a szolgáltatáskiépítési hibákkal rendelkező csoportok megkereséséhez, vagy a HasLicenseErrorsOnly licenc-hozzárendelési hibákkal rendelkező csoportok kereséséhez használt paraméterrel. Ezek a szűrési lehetőségek segítenek a rendszergazdáknak azonosítani a figyelmet igénylő csoportokat.

Példák

1. példa: Az összes csoport lekérése

Connect-Entra -Scopes 'GroupMember.Read.All'
Get-EntraGroup

DisplayName                                       Id                                   MailNickname                                   Description
-----------                                       --                                   ------------                                   -----------
SimpleTestGrp                                     aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb NickName
SimpleGroup                                       bbbbbbbb-1111-2222-3333-cccccccccccc NickName
testGroupInAU10                                   cccccccc-2222-3333-4444-dddddddddddd testGroupInAU10                                testGroupInAU10
My new group                                      dddddddd-3333-4444-5555-eeeeeeeeeeee NotSet                                         New created group
SimpleGroup                                       eeeeeeee-4444-5555-6666-ffffffffffff NickName

Ez a példa bemutatja, hogyan szerezhet be minden csoportot Microsoft Entra ID.

2. példa: Adott csoport lekérése groupId használatával

Connect-Entra -Scopes 'GroupMember.Read.All'
$group = Get-EntraGroup -Filter "DisplayName eq 'Azure Panda'"
Get-EntraGroup -GroupId $group.Id

DisplayName    Id                                   MailNickname        Description         GroupTypes
-----------    --                                   ------------        -----------         ----------
Crimson Eagle  pppppppp-4444-0000-8888-yyyyyyyyyyyy crimsoneaglegroup   Crimson Eagle Group {Unified}

Ez a példa bemutatja, hogyan kérhető le egy adott csoport az azonosító megadásával.

3. példa: Microsoft 365 (egyesített) csoportok lekérése

Connect-Entra -Scopes 'GroupMember.Read.All'
Get-EntraGroup -Filter "groupTypes/any(g:g eq 'Unified')" -Top 4

DisplayName        Id                                     MailNickname     GroupTypes
-----------        --                                     ------------     ----------
Contoso Group      hhhhhhhh-3333-5555-3333-qqqqqqqqqqqq   contosogroup     {Unified}
Crimson Eagle     pppppppp-4444-0000-8888-yyyyyyyyyyyy   crimsoneagle     {Unified}
Bold Falcon      tttttttt-0000-3333-9999-mmmmmmmmmmmm   boldfalcon       {Unified}
Misty Fox        qqqqqqqq-5555-0000-1111-hhhhhhhhhhhh   mistyfox         {Unified}

Ez a példa Microsoft 365 (egyesített) csoportokat kér le. A -Limit a -Topaliasaként is használható.

4. példa: Csoport lekérése a DisplayName alapján

Connect-Entra -Scopes 'GroupMember.Read.All'
Get-EntraGroup -Filter "DisplayName eq 'Azure Panda'"

DisplayName        Id                                   MailNickname     Description        GroupTypes
-----------        --                                   ------------     -----------        ----------
Azure Panda        qqqqqqqq-5555-0000-1111-hhhhhhhhhhhh azurepanda       Azure Panda        {Unified}

Ebben a példában a megjelenítendő névvel kérdezzük le a csoportot.

5. példa: Olyan csoportok lekérése, amelyeknek a DisplayName értéke keresési sztringgel kezdődik

Connect-Entra -Scopes 'GroupMember.Read.All'
Get-EntraGroup -SearchString 'New'

DisplayName             Id                                   MailNickname          Description             GroupTypes
-----------             --                                   ------------          -----------             ----------
New Sparkling Deer      bbbbbbbb-5555-5555-0000-qqqqqqqqqqqq newsparklingdeer New Sparkling Deer Group {Unified}
New Golden Fox          xxxxxxxx-8888-5555-9999-bbbbbbbbbbbb newgoldenfox                  New Golden Fox            {DynamicMembership}

Ez a példa bemutatja, hogyan kérhetők le azok a csoportok, amelyek új szöveget tartalmaznak a megjelenítendő nevekben Microsoft Entra ID.

6. példa: Tulajdonos nélküli csoportok listázása

Connect-Entra -Scopes 'GroupMember.Read.All'
$allGroups = Get-EntraGroup -All
$groupsWithoutOwners = foreach ($group in $allGroups) {
    $owners = Get-EntraGroupOwner -ObjectId $group.Id
    if ($owners.Count -eq 0) {
        $group
    }
}
$groupsWithoutOwners | Format-Table DisplayName, Id, GroupTypes

DisplayName           Id                                   GroupTypes
-----------           --                                   ----------
My new group          aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb {}
HelpDesk admin group  eeeeeeee-4444-5555-6666-ffffffffffff {}

Ez a példa bemutatja, hogyan kérhetők le a csoportok tulajdonosok nélkül. A tulajdonos nélküli csoportok azonosításával az informatikai rendszergazdák javíthatják az általános irányítási és működési hatékonyságot.

7. példa: Üres csoportok listázása

Connect-Entra -Scopes 'GroupMember.Read.All'
$allGroups = Get-EntraGroup -All
$groupsWithoutMembers = foreach ($group in $allGroups) {
    $members = Get-EntraGroupMember -ObjectId $group.Id
    if ($members.Count -eq 0) {
        $group
    }
}
$groupsWithoutMembers | Format-Table DisplayName, Id, GroupTypes

DisplayName           Id                                   GroupTypes
-----------           --                                   ----------
My new group          aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb {}
HelpDesk admin group  eeeeeeee-4444-5555-6666-ffffffffffff {}

Ez a példa bemutatja, hogyan kérhetők le csoportok tagok nélkül. A tag nélküli csoportok azonosításával az informatikai rendszergazdák azonosíthatják és törölhetik a már nem használt vagy elavult csoportokat, amelyek már nem szolgálnak célt.

8. példa: Csoportok lekérése adott tulajdonságokkal

Connect-Entra -Scopes 'GroupMember.Read.All'
Get-EntraGroup -Property Id,DisplayName, SecurityEnabled,Visibility,GroupTypes | Select-Object Id,DisplayName, SecurityEnabled,Visibility,GroupTypes | Format-Table -AutoSize

Id                                   DisplayName                SecurityEnabled Visibility GroupTypes
--                                   -----------                --------------- ---------- ----------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb SimpleGroup               False           Public     {Unified}
eeeeeeee-4444-5555-6666-ffffffffffff My new group              False           Private    {Unified}
bbbbbbbb-5555-5555-0000-qqqqqqqqqqqq HelpDesk admin group      True            {}

Ez a példa bemutatja, hogyan lehet csak egy csoport adott tulajdonságát visszaadni. Használhat -Select aliast vagy -Property.

9. példa: Adott tulajdonságokkal rendelkező csoportok lekérése és a kijelölt tulajdonságok hozzáfűzése

Connect-Entra -Scopes 'GroupMember.Read.All'
Get-EntraGroup -GroupId 'aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb' -Property IsSubscribedByMail -AppendSelected | Select-Object Id, DisplayName, MailEnabled, Visibility, IsSubscribedByMail | Format-Table -AutoSize

Id                                   DisplayName                MailEnabled Visibility IsSubscribedByMail
--                                   -----------                --------------- ---------- ----------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb SimpleGroup               False           Public     False

Ez a példa bemutatja, hogyan fűzhet hozzá egy kijelölt tulajdonságot az alapértelmezett tulajdonságokhoz.

10. példa: Hibákba ütköző csoportok lekérése

Connect-Entra -Scopes 'GroupMember.Read.All'
Get-EntraGroup -HasErrorsOnly

DisplayName           Id                                   MailNickname          Description             GroupTypes ServiceProvisioningErrors
-----------           --                                   ------------          -----------             ---------- -------------------------
Problem Group         aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb problemgroup          Group with errors       {Unified}  {@{ErrorDetail=...}}
Error Test Group      bbbbbbbb-1111-2222-3333-cccccccccccc errortestgroup        Another problem group   {}         {@{ErrorDetail=...}}

Ez a példa bemutatja, hogyan lehet csak olyan csoportokat lekérni, amelyek szolgáltatáskiépítési hibával rendelkeznek. A HasErrorsOnly paraméter szűri az eredményeket, hogy csak a figyelmet igénylő problémákkal rendelkező csoportok jelenjenek meg.

11. példa: Licenchibákkal rendelkező csoportok lekérése

Connect-Entra -Scopes 'GroupMember.Read.All'
Get-EntraGroup -HasLicenseErrorsOnly

DisplayName             Id                                   MailNickname            Description               GroupTypes
-----------             --                                   ------------            -----------               ----------
License Issue Group     cccccccc-2222-3333-4444-dddddddddddd licenseissuegroup       Group with license errors {Unified}
Failed License Group    dddddddd-3333-4444-5555-eeeeeeeeeeee failedlicensegroup      License assignment failed {}

Ez a példa bemutatja, hogyan lehet csak olyan csoportokat lekérni, amelyekben licenchiba lépett fel. Ez olyan csoportok azonosításához hasznos, amelyeknél a licenc-hozzárendelés sikertelen volt, és rendszergazdai figyelmet igényel.

12. példa: Hibaszűrés kombinálása kereséssel

Connect-Entra -Scopes 'GroupMember.Read.All'
Get-EntraGroup -SearchString 'Test' -HasErrorsOnly

DisplayName           Id                                   MailNickname          Description             GroupTypes ServiceProvisioningErrors
-----------           --                                   ------------          -----------             ---------- -------------------------
Test Error Group      bbbbbbbb-1111-2222-3333-cccccccccccc testerrorgroup        Test group with errors  {}         {@{ErrorDetail=...}}

Ez a példa bemutatja, hogyan kombinálhatja a keresési funkciókat a hibaszűréssel, hogy megkeresse azokat a csoportokat, amelyek egy adott névmintával és szolgáltatáskiépítési hibával rendelkeznek.

Paraméterek

-All

Az összes oldal listázása.

Paramétertulajdonságok

Típus:	System.Management.Automation.SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-AppendSelected

Megadja, hogy hozzáfűzze-e a kijelölt tulajdonságokat.

Paramétertulajdonságok

Típus:	System.Management.Automation.SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

Append

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Filter

OData v4.0 szűrőutasítást ad meg. Ez a paraméter szabályozza, hogy mely objektumok lesznek visszaadva.

Paramétertulajdonságok

Típus:	System.String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

GetQuery

Position:	Named
Kötelező:	False
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

Append

Position:	Named
Kötelező:	False
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-GroupId

Egy csoport egyedi azonosítója Microsoft Entra ID (GroupId)

Paramétertulajdonságok

Típus:	System.String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	ObjectId (objektumazonosító)

Paraméterkészletek

GetById

Position:	Named
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

Append

Position:	Named
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-HasErrorsOnly

Csak olyan csoportokat ad vissza, amelyek szolgáltatáskiépítési hibával rendelkeznek.

Paramétertulajdonságok

Típus:	System.Management.Automation.SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

GetQuery

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

GetVague

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

Append

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-HasLicenseErrorsOnly

Csak a licenchibákkal rendelkező csoportokat adja vissza.

Paramétertulajdonságok

Típus:	System.Management.Automation.SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

GetQuery

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

GetVague

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

Append

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Property

Megadja a visszaadandó tulajdonságokat

Paramétertulajdonságok

Típus:	System.String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Select

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-SearchString

Keresési sztringet ad meg.

Paramétertulajdonságok

Típus:	System.String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

GetValue

Position:	Named
Kötelező:	False
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

Append

Position:	Named
Kötelező:	False
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-Top

Megadja a visszaadni kívánt rekordok maximális számát.

Paramétertulajdonságok

Típus:	System.Int32
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Limit

Paraméterkészletek

GetQuery

Position:	Named
Kötelező:	False
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

Append

Position:	Named
Kötelező:	False
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Visszajelzés

Hasznosnak találta ezt az oldalt?

Get-EntraGroup

Syntax

GetQuery (Alapértelmezett)

GetVague

GetById

Append

Description

Példák

1. példa: Az összes csoport lekérése

2. példa: Adott csoport lekérése groupId használatával

3. példa: Microsoft 365 (egyesített) csoportok lekérése

4. példa: Csoport lekérése a DisplayName alapján

5. példa: Olyan csoportok lekérése, amelyeknek a DisplayName értéke keresési sztringgel kezdődik

6. példa: Tulajdonos nélküli csoportok listázása

7. példa: Üres csoportok listázása

8. példa: Csoportok lekérése adott tulajdonságokkal

9. példa: Adott tulajdonságokkal rendelkező csoportok lekérése és a kijelölt tulajdonságok hozzáfűzése

10. példa: Hibákba ütköző csoportok lekérése

11. példa: Licenchibákkal rendelkező csoportok lekérése

12. példa: Hibaszűrés kombinálása kereséssel

Paraméterek

-All

Paramétertulajdonságok

Paraméterkészletek

-AppendSelected

Paramétertulajdonságok

Paraméterkészletek

-Filter

Paramétertulajdonságok

Paraméterkészletek

-GroupId

Paramétertulajdonságok

Paraméterkészletek

-HasErrorsOnly

Paramétertulajdonságok

Paraméterkészletek

-HasLicenseErrorsOnly

Paramétertulajdonságok

Paraméterkészletek

-Property

Paramétertulajdonságok

Paraméterkészletek

-SearchString

Paramétertulajdonságok

Paraméterkészletek

-Top

Paramétertulajdonságok

Paraméterkészletek

CommonParameters

Kapcsolódó hivatkozások

Visszajelzés