Share via

Get-AzureADMSGroup

  • Referência
Módulo:
AzureADPreview

Obtém informações sobre grupos em Azure AD.

Syntax

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

Description

O Get-AzureADMSGroup cmdlet obtém informações sobre grupos no Azure Ative Directory (Azure AD). Para obter um grupo, especifique o parâmetro de identificação. Especifique o parâmetro SearchString ou Filter para encontrar grupos específicos. Se não especificar parâmetros, este cmdlet recebe 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

Este comando recebe todos os grupos em Azure AD.

Exemplo 2: Obter um grupo específico usando um 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

Este comando obtém informações para o grupo que tem o ID especificado.

Exemplo 3: Obter Valores de propriedade atribuídos e DisplayName para todos os grupos

PS C:\> Get-AzureADMSGroup -Select "AssignedLabels,DisplayName"

AssignedLabels                : [{LabelId: "00000000-0000-0000-0000-000000000000", DisplayName: "Confidential"}]
DisplayName                   : Project Icarus 1

AssignedLabels                : [{LabelId: "00000000-0000-0000-0000-000000000000", DisplayName: "Confidential"}]
DisplayName                   : Project Icarus 2

Este comando obtém valores de propriedade atribuídos e DisplayName para todos os grupos.

A propriedade do grupo DesignadosLabels só poderia ser recuperada pelo parâmetro Select.

Exemplo 4: Obter Valores de propriedade atribuídos e DisplayName para um grupo

PS C:\> Get-AzureADMSGroup -Id "11111111-1111-1111-1111-111111111111" -Select "AssignedLabels,DisplayName"

AssignedLabels                : [{LabelId: "00000000-0000-0000-0000-000000000000", DisplayName: "Confidential"}]
DisplayName                   : Project Icarus 1

Este comando obtém valores de propriedade atribuídos e DisplayName para um grupo específico.

A propriedade do grupo DesignadosLabels só poderia ser recuperada pelo parâmetro Select.

Parâmetros

-All

Se for verdade, devolva todos os grupos. Se for falso, devolva 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 corda de filtro oData v3.0 para combinar com um conjunto de grupos.

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

-Id

Especifica a identificação do grupo que este 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 pesquisa. Este cmdlet obtém grupos que têm atributos DisplayName ou Description que correspondem à cadeia de pesquisa.

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

-Select

Especifica uma lista de propriedades de grupo para recuperar.

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 registos que este cmldet obtém. O valor predefinido é 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, Versão=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Saídas

Object

Notas

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 não utilize este cmdlet num ambiente de produção.