Get-MsolGroup

  • Referência
Módulo:
MSOnline

Obtém grupos do Azure Active Directory.

Syntax

Get-MsolGroup
   [-UserObjectId <Guid>]
   [-IsAgentRole]
   [-UserPrincipalName <String>]
   [-GroupType <GroupType>]
   [-HasErrorsOnly]
   [-HasLicenseErrorsOnly <Boolean>]
   [-SearchString <String>]
   [-MaxResults <Int32>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolGroup
   -ObjectId <Guid>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolGroup
   [-UserObjectId <Guid>]
   [-IsAgentRole]
   [-UserPrincipalName <String>]
   [-GroupType <GroupType>]
   [-HasErrorsOnly]
   [-HasLicenseErrorsOnly <Boolean>]
   [-SearchString <String>]
   [-All]
   [-TenantId <Guid>]
   [<CommonParameters>]

Description

O cmdlet Get-MsolGroup obtém grupos do Azure Active Directory. Esse cmdlet pode ser usado para retornar um único grupo, se você especificar o parâmetro ObjectId ou pesquisar em todos os grupos.

Exemplos

Exemplo 1: obter um grupo usando uma ID

PS C:\> Get-MsolGroup -ObjectId af407072-7ae1-4b07-a0ca-6634b7396054

Esse comando retorna o objeto de grupo que tem a ID especificada.

Exemplo 2: Obter todos os grupos

PS C:\> Get-MsolGroup

Esse comando retorna todo o conjunto de grupos para o locatário, até os 250 resultados padrão.

Exemplo 3: obter um grupo usando um nome de entidade de usuário

PS C:\> Get-MsolGroup -isAgentRole -UserPrincipalName "pattifuller@contoso.com"

Este comando retorna os grupos de agente dos que o usuário é um membro. Isto se aplica apenas para empresas que tenham privilégios de parceiro.

Parâmetros

-All

Indica que esse cmdlet retorna todos os resultados encontrados. Não especifique esse parâmetro e o parâmetro MaxResults .

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

-GroupType

Especifica o tipo de grupo a ser obtido. Os valores válidos são Security, MailEnabledSecurity e DistributionList.

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

-HasErrorsOnly

Indica que esse cmdlet retorna apenas grupos que têm erros de validação.

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

-HasLicenseErrorsOnly

Especifica se esse cmdlet retorna apenas grupos de segurança que têm erros de licença.

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

-IsAgentRole

Especifica que esse cmdlet retorna apenas grupos de agentes. Esse valor se aplica somente aos usuários parceiros.

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

-MaxResults

Especifica o número máximo de resultados que esse cmdlet retorna. O valor padrão é 250.

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

-ObjectId

Especifica a ID de objeto exclusivo do grupo a ser obtido.

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

-SearchString

Especifica uma cadeia de caracteres. Esse cmdlet retorna grupos de segurança que têm um nome de exibição que começa com essa cadeia de caracteres.

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

-TenantId

Especifica a ID exclusiva do locatário no qual executar a operação. O valor padrão é o locatário do usuário atual. Esse parâmetro se aplica somente a usuários parceiros.

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

-UserObjectId

Especifica a ID exclusiva de um usuário. Esse cmdlet retorna grupos de segurança aos quais esse usuário pertence. Esse parâmetro deve ser usado junto com o parâmetro IsAgentRole .

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

-UserPrincipalName

Especifica o nome da entidade de usuário de um usuário. Esse cmdlet retorna grupos de segurança aos quais esse usuário pertence. Esse parâmetro deve ser usado junto com o parâmetro IsAgentRole .

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

Saídas

Microsoft.Online.Administration.Group

Esse cmdlet retorna uma lista de grupos, que incluem as seguintes informações:

  • Commonname. O nome comum do grupo.

  • Descrição. Uma descrição do grupo.

  • DisplayName. O nome de exibição do grupo.

  • Emailaddress. O endereço de email do grupo. Este não é retornado para os grupos de segurança.

  • Erros. Uma lista de erros para o grupo.

  • GroupType. O tipo do grupo. Os tipos podem ser SecurityGroup, DistributionList ou MailEnabledSecurityGroup.

  • Issystem. Se esse grupo é ou não um grupo do sistema (criado pelo Azure Active Directory). Estes grupos não podem ser atualizados nem removidos.

  • LastDirSyncTime. A data e a hora da última sincronização do grupo.

  • Managedby. O proprietário do grupo.

  • Objectid. O ID de objeto exclusivo do grupo.

  • Endereços proxy. Os endereços proxy associados a esse grupo (somente para grupos habilitados para email).

  • ValidationStatus. Se o grupo tem ou não algum erro.