Get-EntraGroup

Módulo:: Microsoft.Entra.Groups Module v1.3

Junta-se a um grupo.

Sintaxe

GetQuery (Predefinição)

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>]

Descrição

O Get-EntraGroup cmdlet recebe um grupo no Microsoft Entra ID. Especifique o ObjectId parâmetro para obter um grupo específico.

Pode filtrar resultados para mostrar apenas grupos com problemas usando o HasErrorsOnly parâmetro para encontrar grupos com erros de provisionamento de serviços, ou o HasLicenseErrorsOnly parâmetro para encontrar grupos com erros de atribuição de licenças. Estas opções de filtragem ajudam os administradores a identificar grupos que requerem atenção.

Exemplos

Exemplo 1: Obter todos os grupos

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

Este exemplo demonstra como obter todos os grupos a partir do Microsoft Entra ID.

Exemplo 2: Obter um grupo específico usando um GroupID

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}

Este exemplo demonstra como recuperar um grupo específico fornecendo ID.

Exemplo 3: Recuperar grupos Microsoft 365 (Unificados)

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}

Este exemplo recupera grupos Microsoft 365 (Unificados). Você pode usar -Limit como um alias para -Top.

Exemplo 4: Crie um grupo pelo DisplayName

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}

Neste exemplo, recuperamos o grupo usando o Nome de Exibição.

Exemplo 5: Obtenha grupos cujo DisplayName começa com uma cadeia de pesquisa

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}

Este exemplo demonstra como recuperar grupos que incluem o texto novo nos seus nomes de exibição a partir do Microsoft Entra ID.

Exemplo 6: Listar grupos sem proprietários

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 {}

Este exemplo demonstra como recuperar grupos sem proprietários. Ao identificar grupos sem proprietários, os administradores de TI podem melhorar a governação global e a eficiência operacional.

Exemplo 7: Listar grupos vazios

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 {}

Este exemplo demonstra como recuperar grupos sem membros. Ao identificar grupos sem membros, os administradores de TI podem identificar e limpar grupos não utilizados ou obsoletos que já não têm uma função.

Exemplo 8: Obter grupos com propriedades específicas

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            {}

Este exemplo demonstra como devolver apenas uma propriedade específica de um grupo. Podes usar -Select alias ou -Property.

Exemplo 9: Obtenha grupos com propriedades específicas e adicione as propriedades selecionadas

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

Este exemplo demonstra como adicionar uma propriedade selecionada às propriedades padrão.

Exemplo 10: Obter grupos com erros

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=...}}

Este exemplo demonstra como recuperar apenas grupos que apresentam erros de provisionamento de serviços. O HasErrorsOnly parâmetro filtra os resultados para mostrar apenas grupos com problemas que precisam de atenção.

Exemplo 11: Obter grupos com erros de licença

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 {}

Este exemplo demonstra como recuperar apenas grupos que tenham membros com erros de licença. Isto é útil para identificar grupos onde a atribuição de licenças falhou e necessita de atenção administrativa.

Exemplo 12: Combinar filtragem de erros com pesquisa

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=...}}

Este exemplo demonstra como combinar a funcionalidade de pesquisa com filtragem de erros para encontrar grupos específicos que apresentam tanto um padrão de nomes particular como erros de provisionamento de serviços.

Parâmetros

-All

Liste todas as páginas.

Propriedades dos parâmetros

Tipo:	System.Management.Automation.SwitchParameter
Valor predefinido:	False
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-AppendSelected

Especifica se deve adicionar as propriedades selecionadas.

Propriedades dos parâmetros

Tipo:	System.Management.Automation.SwitchParameter
Valor predefinido:	False
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

Append

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-Filter

Especifica uma instrução de filtro OData v4.0. Este parâmetro controla quais os objetos que são devolvidos.

Propriedades dos parâmetros

Tipo:	System.String
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

GetQuery

Posto:	Named
Obrigatório:	False
Valor do pipeline:	True
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

Append

Posto:	Named
Obrigatório:	False
Valor do pipeline:	True
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-GroupId

O identificador único de um grupo no Microsoft Entra ID (GroupId)

Propriedades dos parâmetros

Tipo:	System.String
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	IdentificadorDoObjeto

Conjuntos de parâmetros

GetById

Posto:	Named
Obrigatório:	True
Valor do pipeline:	True
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

Append

Posto:	Named
Obrigatório:	True
Valor do pipeline:	True
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-HasErrorsOnly

Devolve apenas grupos que apresentam erros de provisionamento de serviços.

Propriedades dos parâmetros

Tipo:	System.Management.Automation.SwitchParameter
Valor predefinido:	False
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

GetQuery

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

GetVague

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

Append

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-HasLicenseErrorsOnly

Só devolve grupos que tenham membros com erros de licença.

Propriedades dos parâmetros

Tipo:	System.Management.Automation.SwitchParameter
Valor predefinido:	False
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

GetQuery

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

GetVague

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

Append

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-Property

Especifica propriedades a serem devolvidas

Propriedades dos parâmetros

Tipo:	System.String[]
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	Select

Conjuntos de parâmetros

(All)

Posto:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-SearchString

Especifica uma cadeia de pesquisa.

Propriedades dos parâmetros

Tipo:	System.String
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

GetValue

Posto:	Named
Obrigatório:	False
Valor do pipeline:	True
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

Append

Posto:	Named
Obrigatório:	False
Valor do pipeline:	True
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-Top

Especifica o número máximo de registos a devolver.

Propriedades dos parâmetros

Tipo:	System.Int32
Valor predefinido:	None
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	Limit

Conjuntos de parâmetros

GetQuery

Posto:	Named
Obrigatório:	False
Valor do pipeline:	True
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

Append

Posto:	Named
Obrigatório:	False
Valor do pipeline:	True
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Comentários

Esta página foi útil?

Get-EntraGroup

Sintaxe

GetQuery (Predefinição)

GetVague

GetById

Append

Descrição

Exemplos

Exemplo 1: Obter todos os grupos

Exemplo 2: Obter um grupo específico usando um GroupID

Exemplo 3: Recuperar grupos Microsoft 365 (Unificados)

Exemplo 4: Crie um grupo pelo DisplayName

Exemplo 5: Obtenha grupos cujo DisplayName começa com uma cadeia de pesquisa

Exemplo 6: Listar grupos sem proprietários

Exemplo 7: Listar grupos vazios

Exemplo 8: Obter grupos com propriedades específicas

Exemplo 9: Obtenha grupos com propriedades específicas e adicione as propriedades selecionadas

Exemplo 10: Obter grupos com erros

Exemplo 11: Obter grupos com erros de licença

Exemplo 12: Combinar filtragem de erros com pesquisa

Parâmetros

-All

Propriedades dos parâmetros

Conjuntos de parâmetros

-AppendSelected

Propriedades dos parâmetros

Conjuntos de parâmetros

-Filter

Propriedades dos parâmetros

Conjuntos de parâmetros

-GroupId

Propriedades dos parâmetros

Conjuntos de parâmetros

-HasErrorsOnly

Propriedades dos parâmetros

Conjuntos de parâmetros

-HasLicenseErrorsOnly

Propriedades dos parâmetros

Conjuntos de parâmetros

-Property

Propriedades dos parâmetros

Conjuntos de parâmetros

-SearchString

Propriedades dos parâmetros

Conjuntos de parâmetros

-Top

Propriedades dos parâmetros

Conjuntos de parâmetros

CommonParameters

Ligações Relacionadas

Comentários