Partilhar via

Get-MsolGroup

  • Referência
Módulo:
MSOnline

Obtém grupos do Azure Active Directory.

Sintaxe

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. Este cmdlet pode ser utilizado para devolver um único grupo, se especificar o parâmetro ObjectId ou para procurar em todos os grupos.

Exemplos

Exemplo 1: Obter um grupo com um ID

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

Este comando devolve o objeto de grupo que tem o ID especificado.

Exemplo 2: Obter todos os grupos

PS C:\> Get-MsolGroup

Este comando devolve todo o conjunto de grupos para o inquilino, até aos 250 resultados predefinidos.

Exemplo 3: Obter um grupo com um nome principal de utilizador

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

Este comando devolve os grupos de agentes dos quais um utilizador é membro. Isto aplica-se apenas a empresas com privilégios de parceiros.

Parâmetros

-All

Indica que este cmdlet devolve todos os resultados que encontrar. Não especifique este parâmetro e o parâmetro MaxResults .

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-GroupType

Especifica o tipo de grupos a obter. Os valores válidos são Segurança, MailEnabledSecurity e DistributionList.

Tipo:GroupType
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-HasErrorsOnly

Indica que este cmdlet devolve apenas grupos que têm erros de validação.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-HasLicenseErrorsOnly

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

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-IsAgentRole

Especifica que este cmdlet devolve apenas grupos de agentes. Este valor aplica-se apenas aos utilizadores parceiros.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-MaxResults

Especifica o número máximo de resultados que este cmdlet devolve. O valor predefinido é 250.

Tipo:Int32
Position:Named
Default value:250
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ObjectId

Especifica o ID de objeto exclusivo do grupo a obter.

Tipo:Guid
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-SearchString

Especifica uma cadeia. Este cmdlet devolve grupos de segurança que têm um nome a apresentar que começa com esta cadeia.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-TenantId

Especifica o ID exclusivo do inquilino no qual efetuar a operação. O valor predefinido é o inquilino do utilizador atual. Este parâmetro aplica-se apenas aos utilizadores parceiros.

Tipo:Guid
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-UserObjectId

Especifica o ID exclusivo de um utilizador. Este cmdlet devolve grupos de segurança aos quais este utilizador pertence. Este parâmetro tem de ser utilizado juntamente com o parâmetro IsAgentRole .

Tipo:Guid
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-UserPrincipalName

Especifica o nome principal de utilizador de um utilizador. Este cmdlet devolve grupos de segurança aos quais este utilizador pertence. Este parâmetro tem de ser utilizado juntamente com o parâmetro IsAgentRole .

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Saídas

Microsoft.Online.Administration.Group

Este cmdlet devolve 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 a apresentar do grupo.

  • EmailAddress. Os endereços de e-mail do grupo. Isto não é devolvido para 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 este grupo é ou não um grupo de sistema (criado pelo Azure Active Directory). Estes grupos não podem ser atualizados ou removidos.

  • LastDirSyncTime. A data e hora em que o grupo foi sincronizado pela última vez.

  • ManagedBy. O proprietário do grupo.

  • ObjectId. O ID de objeto exclusivo do grupo.

  • Endereços Proxy. Os endereços proxy associados a este grupo (apenas para grupos com capacidade de correio).

  • ValidationStatus. Se o grupo tem ou não erros.