Get-UnifiedGroup

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

Exemplos

Exemplo 1

Get-UnifiedGroup

Exemplo 2

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

Exemplo 3

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

Exemplo 4

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

Exemplo 5

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

Parâmetros

-Anr

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

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

Propriedades do parâmetro

Conjuntos de parâmetros

-Filter

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

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

• Coloque todo o filtro OPATH entre aspas " ". Se o filtro contiver valores de sistema (por exemplo, $true, $falseou $null), utilize aspas únicas ' ' em vez disso. Embora este parâmetro seja uma cadeia (não um bloco de sistema), também pode utilizar chavetas { }, mas apenas se o filtro não contiver variáveis.
• A propriedade é uma propriedade filtráveis. Para obter mais informações sobre as propriedades filtráveis no servidor Exchange e Exchange Online, veja Propriedades filtráveis para o parâmetro Filter.
• ComparisonOperator é um operador de comparação OPATH (por exemplo -eq , para igual e -like para comparação de cadeias). Para obter mais informações sobre operadores de comparação, veja about_Comparison_Operators.
• Valor é o valor da propriedade a procurar. Coloque os valores de texto e as variáveis entre plicas ('Value' ou '$Variable'). Se um valor de variável contiver aspas únicas, terá de identificar (escape) as aspas únicas para expandir a variável corretamente. Por exemplo, em vez de '$User', utilize '$($User -Replace "'","''")'. Não coloque números inteiros ou valores do sistema entre aspas (por exemplo, utilize 500, $true, $falseou $null em alternativa).

Pode encadear múltiplos critérios de pesquisa em conjunto com 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, veja Informações adicionais sobre sintaxe OPATH.

Propriedades do parâmetro

Conjuntos de parâmetros

-Identity

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro Identidade especifica o Grupo do Microsoft 365 que pretende ver. Pode utilizar qualquer valor que identifique exclusivamente o Grupo do Microsoft 365. Por exemplo:

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

Nota: pode utilizar o valor DisplayName para identificar o Grupo do Microsoft 365, mas os resultados não são garantidos como exclusivos. Se tiver de devolver um resultado singular e exclusivo, utilize um identificador exclusivo para o Grupo do Microsoft 365.

Atenção: o valor $null ou um valor inexistente para o parâmetro Identidade devolve todos os objetos como se tivesse executado o comando Get- sem o parâmetro Identity. Verifique se as listas de valores do parâmetro Identity estão corretas e não contêm valores de $null inexistentes.

Propriedades do parâmetro

Conjuntos de parâmetros

-IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O comutador IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames especifica se pretende devolver os endereços SMTP e os nomes a apresentar da propriedade AcceptMessagesOnlyFromSendersOrMembers na propriedade AcceptMessagesOnlyFromSendersOrMembersWithDisplayNames. Não é preciso especificar um valor com essa opção.

Este parâmetro foi introduzido para restaurar identificadores legíveis por humanos nos resultados do cmdlet. Se não utilizar este comutador, os destinatários AcceptMessagesOnlyFromSendersOrMembers são apresentados como GUIDs e a propriedade AcceptMessagesOnlyFromSendersOrMembersWithDisplayNames está vazia.

Propriedades do parâmetro

Conjuntos de parâmetros

-IncludeAllProperties

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

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

Se não utilizar este comutador, os valores de algumas propriedades (por exemplo, CalendarMemberReadOnly, CalendarUrl, InboxUrl, PeopleUrl e PhotoUrl) poderão aparecer em branco.

Propriedades do parâmetro

Conjuntos de parâmetros

-IncludeBypassModerationFromSendersOrMembersWithDisplayNames

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O comutador IncludeBypassModerationFromSendersOrMembersWithDisplayNames especifica se pretende devolver os endereços SMTP e os nomes a apresentar da propriedade BypassModerationFromSendersOrMembers na propriedade BypassModerationFromSendersOrMembersWithDisplayNames. Não é preciso especificar um valor com essa opção.

Este parâmetro foi introduzido para restaurar identificadores legíveis por humanos nos resultados do cmdlet. Se não utilizar este comutador, os destinatários bypassModerationFromSendersOrMembers são apresentados como GUIDs e a propriedade BypassModerationFromSendersOrMembersWithDisplayNames está vazia.

Propriedades do parâmetro

Conjuntos de parâmetros

-IncludeGrantSendOnBehalfToWithDisplayNames

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O comutador IncludeGrantSendOnBehalfToWithDisplayNames especifica se pretende devolver os endereços SMTP e os nomes a apresentar dos destinatários GrantSendOnBehalfTo na propriedade GrantSendOnBehalfToWithDisplayNames. Não é preciso especificar um valor com essa opção.

Este parâmetro foi introduzido para restaurar identificadores legíveis por humanos nos resultados do cmdlet. Se não utilizar este comutador, os destinatários grantSendOnBehalfTo são apresentados como GUIDs e a propriedade GrantSendOnBehalfToWithDisplayNames está vazia.

Propriedades do parâmetro

Conjuntos de parâmetros

-IncludeModeratedByWithDisplayNames

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O comutador IncludeModeratedByWithDisplayNames especifica se pretende devolver os endereços SMTP e os nomes a apresentar dos destinatários ModeratedBy na propriedade ModeratedByWithDisplayNames. Não é preciso especificar um valor com essa opção.

Este parâmetro foi introduzido para restaurar identificadores legíveis por humanos nos resultados do cmdlet. Se não utilizar este comutador, os destinatários ModeratedBy são apresentados como GUIDs e a propriedade ModeratedByWithDisplayNames está vazia.

Propriedades do parâmetro

Conjuntos de parâmetros

-IncludeRejectMessagesFromSendersOrMembersWithDisplayNames

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O comutador IncludeRejectMessagesFromSendersOrMembersWithDisplayNames especifica se pretende devolver os endereços SMTP e os nomes a apresentar da propriedade RejectMessagesFromSendersOrMembers na propriedade RejectMessagesFromSendersOrMembersWithDisplayNames. Não é preciso especificar um valor com essa opção.

Este parâmetro foi introduzido para restaurar identificadores legíveis por humanos nos resultados do cmdlet. Se não utilizar este comutador, os destinatários ModeratedBy são apresentados como GUIDs e a propriedade RejectMessagesFromSendersOrMembersWithDisplayNames está vazia.

Propriedades do parâmetro

Conjuntos de parâmetros

-IncludeSoftDeletedGroups

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

O comutador IncludeSoftDeletedGroups especifica se deve incluir Grupos do Microsoft 365 eliminados de forma recuperável nos resultados. Não é preciso especificar um valor com essa opção.

Os Grupos do Microsoft 365 eliminados de forma recuperável são grupos eliminados que ainda são recuperáveis.

Propriedades do parâmetro

Conjuntos de parâmetros

-ResultSize

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

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

Conjuntos de parâmetros

-SortBy

Aplicável: Exchange Online, Suplemento de segurança incorporado para caixas de correio no local

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 vista predefinida não incluir a propriedade pela qual está a ordenar, pode acrescentar o comando com | Format-Table -Auto Property1,Property2,...PropertyX. para criar uma nova vista que contenha todas as propriedades que pretende ver. Os caracteres curinga (*) nos nomes de propriedade são permitidos.

É possível classificar pelas seguintes propriedades:

• Nome
• DisplayName
• Alias

Propriedades do parâmetro

Conjuntos de parâmetros

CommonParameters