Get-MsolGroup

  • Referência
Módulo:
MSOnline

Recebe grupos do Azure Ative 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 recebe grupos do Azure Ative Directory. Este cmdlet pode ser usado para devolver um único grupo, se especificar o parâmetro ObjectId , ou para pesquisar dentro de todos os grupos.

Exemplos

Exemplo 1: Obter um grupo usando 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é os 250 resultados predefinidos.

Exemplo 3: Obter um grupo usando um nome principal do utilizador

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

Este comando devolve os grupos de agentes dos que um utilizador é membro. Isto aplica-se apenas às empresas que têm privilégios de parceiro.

Parâmetros

-All

Indica que este cmdlet devolve todos os resultados que encontra. Não especifique este 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 grupos a obter. Valores válidos são Segurança, MailEnabledSecurity e DistributionList.

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

-HasErrorsOnly

Indica que este cmdlet devolve 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 este cmdlet devolve apenas grupos de segurança que tenham erros de licença.

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

-IsAgentRole

Especifica que este cmdlet devolve apenas grupos de agentes. Este valor aplica-se apenas aos utilizadores 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 este cmdlet devolve. O valor predefinido é de 250.

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

-ObjectId

Especifica o ID do objeto único do grupo para obter.

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

-SearchString

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

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

-TenantId

Especifica a identificação única do inquilino para realizar a operação. O valor predefinido é o inquilino do utilizador atual. Este parâmetro aplica-se apenas aos utilizadores parceiros.

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

-UserObjectId

Especifica o ID único de um utilizador. Este cmdlet devolve os grupos de segurança aos quais este utilizador pertence. Este parâmetro deve ser utilizado juntamente 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 principal do utilizador de um utilizador. Este cmdlet devolve os grupos de segurança aos quais este utilizador pertence. Este parâmetro deve ser utilizado juntamente 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

Este cmdlet devolve uma lista de grupos, que incluem as seguintes informações:

  • Nome Comum. O nome comum do grupo.

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

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

  • E-mailAddress. 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.

  • GrupoType. 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 Ative Directory). Estes grupos não podem ser atualizados ou removidos.

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

  • Gerido Por. O dono do grupo.

  • ObjectId. O único iD do objeto do grupo.

  • Endereços de procuração. Os endereços proxy associados a este grupo (apenas para grupos habilitados por correio).

  • ValidaçãoStatus. Se o grupo tem ou não erros.