Get-UnifiedGroup

Módulo:
Exchange PowerShell

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 de 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.

Sintaxe

Identity (Default) 

Get-UnifiedGroup
    [[-Identity] <UnifiedGroupIdParameter>]
    [-Filter <String>]
    [-IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames]
    [-IncludeAllProperties]
    [-IncludeBypassModerationFromSendersOrMembersWithDisplayNames]
    [-IncludeGrantSendOnBehalfToWithDisplayNames]
    [-IncludeModeratedByWithDisplayNames]
    [-IncludeRejectMessagesFromSendersOrMembersWithDisplayNames]
    [-IncludeSoftDeletedGroups]
    [-ResultSize <Unlimited>]
    [-SortBy <String>]
    [<CommonParameters>]

AnrSet 

Get-UnifiedGroup
    [-Anr <String>]
    [-Filter <String>]
    [-IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames]
    [-IncludeAllProperties]
    [-IncludeBypassModerationFromSendersOrMembersWithDisplayNames]
    [-IncludeGrantSendOnBehalfToWithDisplayNames]
    [-IncludeModeratedByWithDisplayNames]
    [-IncludeRejectMessagesFromSendersOrMembersWithDisplayNames]
    [-IncludeSoftDeletedGroups]
    [-ResultSize <Unlimited>]
    [-SortBy <String>]
    [<CommonParameters>]

Description

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

Para executar esse cmdlet, você precisa ter permissões. Embora este artigo 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 resumida 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 todos os 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 Grupo do Microsoft 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 criados quando um Microsoft Team é criado.

Parâmetros

-Anr

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

AnrSet
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Filter

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

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

  • Coloque todo o filtro OPATH entre aspas duplas " ". Se o filtro contiver valores do sistema (por exemplo, $true, $false, ou $null), use aspas simples " '. Embora esse parâmetro seja uma cadeia de caracteres (não um bloco do sistema), você também poderá usar chaves { }, mas somente se o filtro não contiver variáveis.
  • A propriedade é uma propriedade filtrável. Para obter mais informações sobre as propriedades filtráveis no Exchange Server e no Exchange Online, consulte Propriedades filtráveis para o parâmetro Filtro.
  • ComparisonOperator é um operador de comparação OPATH (por exemplo, -eq para igual 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. Coloque os valores de texto e variáveis entre aspas simples ('Value' ou '$Variable'). Se um valor de variável contiver aspas simples, você precisará identificar (escapar) as aspas simples para expandir a variável corretamente. Por exemplo, em vez de '$User', use '$($User -Replace "'","''")'. Não coloque números inteiros ou valores do sistema entre aspas (por exemplo, use 500, $true, $false, ou $null em vez disso).

Você pode encadear vários critérios de pesquisa usando os operadores -and lógicos 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.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Identity

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

O parâmetro Identity especifica o Grupo do Microsoft 365 que você deseja exibir. Você pode usar qualquer valor que identifique exclusivamente o Grupo do 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 não há garantia de que os resultados sejam exclusivos. Se você precisar retornar um resultado singular e exclusivo, use um identificador exclusivo para o Grupo do Microsoft 365.

Cuidado: O valor $null ou um valor inexistente para o parâmetro Identity retorna todos os objetos como se você tivesse executado o comando Get- sem o parâmetro Identity. Verifique se todas as listas de valores para o parâmetro Identity são precisas e não contêm valores de $null inexistentes.

Propriedades do parâmetro

Tipo:UnifiedGroupIdParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Identity
Cargo:1
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

A opção IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames especifica se os endereços SMTP devem ser retornados e os nomes de exibição dos destinatários AcceptMessagesOnlyFromSendersOrMembers na propriedade AcceptMessagesOnlyFromSendersOrMembersWithDisplayNames. Não é preciso especificar um valor com essa opção.

Esta opção foi introduzida para restaurar identificadores legíveis nos resultados do cmdlet. Se você não usar essa opção, os destinatários AcceptMessagesOnlyFromSendersOrMembers serão mostrados como GUIDs e a propriedade AcceptMessagesOnlyFromSendersOrMembersWithDisplayNames estará vazia.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-IncludeAllProperties

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

A opção IncludeAllProperties especifica se os valores de todas as propriedades devem ser incluídos 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.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-IncludeBypassModerationFromSendersOrMembersWithDisplayNames

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

A opção IncludeBypassModerationFromSendersOrMembersWithDisplayNames especifica se os endereços SMTP devem ser retornados e os nomes de exibição dos destinatários BypassModerationFromSendersOrMembers na propriedade BypassModerationFromSendersOrMembersWithDisplayNames. Não é preciso especificar um valor com essa opção.

Esta opção foi introduzida para restaurar identificadores legíveis nos resultados do cmdlet. Se você não usar essa opção, os destinatários BypassModerationFromSendersOrMembers serão mostrados como GUIDs e a propriedade BypassModerationFromSendersOrMembersWithDisplayNames estará vazia.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-IncludeGrantSendOnBehalfToWithDisplayNames

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

A opção IncludeGrantSendOnBehalfToWithDisplayNames especifica se os endereços SMTP devem ser retornados e os nomes de exibição dos destinatários GrantSendOnBehalfTo na propriedade GrantSendOnBehalfToWithDisplayNames. Não é preciso especificar um valor com essa opção.

Esta opção foi introduzida para restaurar identificadores legíveis nos resultados do cmdlet. Se você não usar essa opção, os destinatários GrantSendOnBehalfTo serão mostrados como GUIDs e a propriedade GrantSendOnBehalfToWithDisplayNames estará vazia.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-IncludeModeratedByWithDisplayNames

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

A opção IncludeModeratedByWithDisplayNames especifica se os endereços SMTP devem ser retornados e os nomes de exibição dos destinatários ModeratedBy na propriedade ModeratedByWithDisplayNames. Não é preciso especificar um valor com essa opção.

Esta opção foi introduzida para restaurar identificadores legíveis nos resultados do cmdlet. Se você não usar essa opção, os destinatários ModeratedBy serão mostrados como GUIDs e a propriedade ModeratedByWithDisplayNames estará vazia.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-IncludeRejectMessagesFromSendersOrMembersWithDisplayNames

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

A opção IncludeRejectMessagesFromSendersOrMembersWithDisplayNames especifica se os endereços SMTP devem ser retornados e os nomes de exibição dos destinatários RejectMessagesFromSendersOrMembers na propriedade RejectMessagesFromSendersOrMembersWithDisplayNames. Não é preciso especificar um valor com essa opção.

Esta opção foi introduzida para restaurar identificadores legíveis nos resultados do cmdlet. Se você não usar essa opção, os destinatários ModeratedBy serão mostrados como GUIDs e a propriedade RejectMessagesFromSendersOrMembersWithDisplayNames estará vazia.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-IncludeSoftDeletedGroups

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

O comutador IncludeSoftDeletedGroups especifica se os Grupos do Microsoft 365 excluídos temporariamente devem ser incluídos nos resultados. Não é preciso especificar um valor com essa opção.

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ResultSize

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

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.

Propriedades do parâmetro

Tipo:Unlimited
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SortBy

Aplicável: Exchange Online, complemento de segurança interno para caixas de correio locais

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 contém 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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.