Compartilhar via

Get-UnifiedGroup

  • Referência
Módulo:
ExchangePowerShell
Aplica-se a:
Exchange Online, Exchange Online Protection

Esse cmdlet só está disponível no serviço baseado em nuvem.

Use o cmdlet Get-UnifiedGroup para exibir Grupos do Microsoft 365 em sua organização baseada em nuvem. Para exibir membros, proprietários e assinantes para Grupos do Microsoft 365, use o cmdlet Get-UnifiedGroupLinks.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

Get-UnifiedGroup
   [[-Identity] <UnifiedGroupIdParameter>]
   [-Filter <String>]
   [-IncludeAllProperties]
   [-IncludeSoftDeletedGroups]
   [-ResultSize <Unlimited>]
   [-SortBy <String>]
   [<CommonParameters>]
Get-UnifiedGroup
   [-Anr <String>]
   [-Filter <String>]
   [-IncludeAllProperties]
   [-IncludeSoftDeletedGroups]
   [-ResultSize <Unlimited>]
   [-SortBy <String>]
   [<CommonParameters>]

Description

Grupos do Microsoft 365 são objetos de grupo disponíveis em Microsoft 365 serviços.

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Exemplos

Exemplo 1

Get-UnifiedGroup

Este exemplo retorna uma lista de resumo de todos os Grupos do Microsoft 365.

Exemplo 2

Get-UnifiedGroup | Format-List DisplayName,EmailAddresses,Notes,ManagedBy,AccessType

Este exemplo retorna as seguintes informações sobre todas as Grupos do Microsoft 365:

  • Nome diferenciado (DN)
  • Nome para exibição
  • Descrição
  • Proprietários
  • Privacidade

Exemplo 3

Get-UnifiedGroup -Identity "Marketing Department" | Format-List

Este exemplo retorna informações detalhadas sobre o Microsoft Grupo 365 chamado Departamento de Marketing.

Exemplo 4

Get-UnifiedGroup | Where-Object {-Not $_.ManagedBy}

Este exemplo retorna Grupos do Microsoft 365 que não têm um proprietário.

Exemplo 5

Get-UnifiedGroup -Filter {ResourceProvisioningOptions -eq "Team"}

Este exemplo retorna Grupos do Microsoft 365 que são criadas quando uma equipe de Microsoft é criada.

Parâmetros

-Anr

Esse parâmetro está reservado para uso interno da Microsoft.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Filter

O parâmetro Filter usa a sintaxe OPATH para filtrar os resultados pelas propriedades e valores especificados. Os critérios de pesquisa usam a sintaxe "Property -ComparisonOperator 'Value'".

  • Inclua todo o filtro OPATH nas aspas duplas " ". Se o filtro contiver valores do sistema (por exemplo, $true, $falseou $null), use aspas individuais ' ' em vez disso. Embora esse parâmetro seja uma cadeia de caracteres (não um bloco do sistema), você também pode usar chaves { }, mas somente se o filtro não contiver variáveis.
  • A propriedade é uma propriedade filtrada. Para obter mais informações sobre as propriedades filtradas no servidor exchange e Exchange Online, consulte Propriedades filtreáveis para o parâmetro Filter.
  • ComparisonOperator é um operador de comparação OPATH (por exemplo -eq , para iguais e -like para comparação de cadeia de caracteres). Para obter mais informações sobre operadores de comparação, consulte about_Comparison_Operators.
  • Valor é o valor da propriedade a ser pesquisado. Inclua valores e variáveis de texto em aspas individuais ('Value' ou '$Variable'). Se um valor variável contiver aspas individuais, você precisará identificar (escapar) as aspas individuais para expandir a variável corretamente. Por exemplo, em vez de '$User', use '$($User -Replace "'","''")'. Não inclua inteiros ou valores do sistema entre aspas (por exemplo, use 500, $true, $falseou $null em vez disso).

Você pode encadear vários critérios de pesquisa usando os operadores lógicos -and e -or. Por exemplo: "Criteria1 -and Criteria2" ou "(Criteria1 -and Criteria2) -or Criteria3".

Para obter informações detalhadas sobre filtros OPATH no Exchange, consulte Informações adicionais de sintaxe OPATH.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Identity

O parâmetro Identity especifica o grupo Microsoft 365 que você deseja exibir. Você pode usar qualquer valor que identifique exclusivamente o grupo Microsoft 365. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • DN canônico
  • GUID

Observação: você pode usar o valor DisplayName para identificar o grupo Microsoft 365, mas os resultados não são garantidos como exclusivos. Se você precisar retornar um resultado singular e exclusivo, use um identificador exclusivo para o grupo Microsoft 365.

Type:UnifiedGroupIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-IncludeAllProperties

A opção IncludeAllProperties especifica se deve incluir os valores de todas as propriedades nos resultados. Não é preciso especificar um valor com essa opção.

Se você não usar essa opção, os valores de algumas propriedades (por exemplo, CalendarMemberReadOnly, CalendarUrl, InboxUrl, PeopleUrl e PhotoUrl) poderão aparecer em branco.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-IncludeSoftDeletedGroups

A opção IncludeSoftDeletedGroups especifica se deve incluir Grupos do Microsoft 365 excluídos suavemente nos resultados. Não é preciso especificar um valor com essa opção.

Os Grupos do Microsoft 365 excluídos são grupos excluídos que ainda podem ser recuperados.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-ResultSize

O parâmetro ResultSize especifica o número máximo de resultados a serem retornados. Caso pretenda retornar todas as solicitações correspondentes à consulta, use unlimited como valor desse parâmetro. O valor padrão é 1000.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-SortBy

O parâmetro SortBy especifica a propriedade pela qual classificar os resultados. Você pode classificar apenas por uma propriedade de cada vez. Os resultados são classificados em ordem crescente.

Se a exibição padrão não incluir a propriedade pela qual você está classificando, você poderá acrescentar o comando com | Format-Table -Auto Property1,Property2,...PropertyX. para criar uma nova exibição que contenha todas as propriedades que você deseja ver. Os caracteres curinga (*) nos nomes de propriedade são permitidos.

É possível classificar pelas seguintes propriedades:

  • Nome
  • DisplayName
  • Alias
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection