Get-AzureADMSGroup

  • Referência
Módulo:
AzureAD

Obtém informações sobre grupos na ID de Microsoft Entra (por meio do MS Graph).

Syntax

Get-AzureADMSGroup
   [-All <Boolean>]
   [-Top <Int32>]
   [-Filter <String>]
   [<CommonParameters>]
Get-AzureADMSGroup
   [-SearchString <String>]
   [-All <Boolean>]
   [<CommonParameters>]
Get-AzureADMSGroup
   -Id <String>
   [-All <Boolean>]
   [<CommonParameters>]

Description

O cmdlet Get-AzureADMSGroup obtém informações sobre grupos na ID de Microsoft Entra usando o Microsoft Graph. Para obter um grupo, especifique o parâmetro Id. Especifique o parâmetro SearchString ou Filter para localizar grupos específicos. Se você não especificar parâmetros, esse cmdlet obterá todos os grupos.

Exemplos

Exemplo 1: Obter todos os grupos

PS C:\> Get-AzureADMSGroup

Id                            : d539a25e-2db2-482a-9dcb-2a0b27fe4f27
Description                   :
OnPremisesSyncEnabled         :
DisplayName                   :
ADSyncOperators
OnPremisesLastSyncDateTime    :
Mail                          :
MailEnabled                   : False
MailNickname                  : ADSyncOperators
OnPremisesSecurityIdentifier  : S-1-5-21-2695029449-1154706203-1063139792-1243
ProxyAddresses                : {}
SecurityEnabled               : True
GroupTypes                    : {}
MembershipRule                :
MembershipRuleProcessingState :


Id                            : d98ddc78-6e8d-4f0d-8a3f-b923c6ebc14b
Description                   :
OnPremisesSyncEnabled         :
DisplayName                   : Project Icarus
OnPremisesLastSyncDateTime    :
Mail                          :
MailEnabled                   : False
MailNickname                  : 60f3d02c-0c6e-41da-bb64-128c73b4d9e6
OnPremisesSecurityIdentifier  :
ProxyAddresses                : {}
SecurityEnabled               : True
GroupTypes                    : {DynamicMembership}
MembershipRule                : (user.jobtitle -eq "Sales manager") -or ((user.department -eq "Marketing") -and (user.country -eq "Greece"))
MembershipRuleProcessingState : On

Esse comando obtém todos os grupos na ID de Microsoft Entra.

Exemplo 2: Obter um grupo específico usando uma ID

PS C:\> Get-AzureADMSGroup -Id "d98ddc78-6e8d-4f0d-8a3f-b923c6ebc14b"

Id                            : d98ddc78-6e8d-4f0d-8a3f-b923c6ebc14b
Description                   :
OnPremisesSyncEnabled         :
DisplayName                   : Project Icarus
OnPremisesLastSyncDateTime    :
Mail                          :
MailEnabled                   : False
MailNickname                  : 60f3d02c-0c6e-41da-bb64-128c73b4d9e6
OnPremisesSecurityIdentifier  :
ProxyAddresses                : {}
SecurityEnabled               : True
GroupTypes                    : {DynamicMembership}
MembershipRule                : (user.jobtitle -eq "Sales manager") -or ((user.department -eq "Marketing") -and (user.country -eq "Greece"))
MembershipRuleProcessingState : On

Esse comando obtém informações para o grupo que tem a ID especificada.

Parâmetros

-All

Se for true, retorne todos os grupos. Se for false, retorne o número de objetos especificados pelo parâmetro Top

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

-Filter

Especifica uma cadeia de caracteres de filtro oData v3.0 para corresponder a um conjunto de grupos.

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

-Id

Especifica a ID do grupo que esse cmdlet obtém.

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

-SearchString

Especifica uma cadeia de caracteres de pesquisa. Esse cmdlet obtém grupos que têm atributos DisplayName ou Description que correspondem à cadeia de caracteres de pesquisa.

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

-Top

Especifica o número máximo de registros que esse cmldet obtém. O valor padrão é 100.

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

Entradas

String

System.Nullable'1[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Saídas

Object

Observações

Consulte o guia de migração para Get-AzureADMSGroup para o Microsoft Graph PowerShell.

Este cmdlet está atualmente em Visualização Pública. Enquanto um cmdlet está em Visualização Pública, podemos fazer alterações no cmdlet que podem ter efeitos inesperados. Recomendamos que você não use esse cmdlet em um ambiente de produção.